planning-documents

name	Planning Documents
description	Naming conventions for planning documents in docs/agent-guide/. Use when creating plans, PRDs, research reports, idea capture or other workflow documents. Triggers on (1) creating new planning documents, (2) naming PRDs or research reports, (3) questions about document organization in docs/agent-guide/.

Planning Documents

All workflow documents live in docs/agent-guide/ with a structured naming scheme.

Primary Documents (PRDs)

Pattern: docs/agent-guide/NNN-concept.md

Component	Description	Example
NNN	Three-digit sequence number	025
concept	Kebab-case description	compositor, event-parsing

No underscores in the primary document name.

Examples:

• docs/agent-guide/025-compositor.md
• docs/agent-guide/010-event-parsing.md

Supporting Documents

Pattern	Purpose	Example
NNN-concept_report.md	Research findings	025-compositor_report.md
NNN-concept_library_report.md	Library-specific research	025-compositor_textual_report.md
NNN-concept_idea.md	Some idea/brainstorm capture	011-cli-api_idea2.md

Determining Next Sequence Number

Check existing documents:

ls docs/agent-guide/*.md | sort -t- -k1 -n | tail -5

Use the next available three-digit number.