Planning Documents

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/.

rcmerci 2e3b031 1.4 KB Updated

File contents

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.

rcmerci/skills/tree/main/skills/planning-documents commit 2e3b031200

Frequently asked questions

npx skillmds@latest add rcmerci/planning-documents