workspace-guide

Installation
SKILL.md

Workspace Conventions

These conventions apply whenever you detect workspace markers in the project:

  • Directories: docs/, tools/
  • Instruction files: AGENTS.md, CLAUDE.md, GEMINI.md
  • Numbered files: NNN-*.ext pattern (e.g., 001-arquitectura.md)

If any of these markers exist, follow all conventions below automatically.

1. Where Does This Go?

What are you creating? Destination
Architecture/design documentation docs/arquitectura/NNN-<name>.md
Work plan or analysis docs/planes/NNN-<name>.md
Architecture Decision Record docs/decisiones/NNN-<name>.md
Manual, setup, or config guide docs/manuales/NNN-<name>.md
Functional/technical spec docs/especificaciones/NNN-<name>.md
SQL script or data analysis docs/scripts/<topic>/NNN-<name>.sql
Related skills

More from tacuchi/workspace-tools

Installs
8
First Seen
Mar 16, 2026