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

- Skill: `rcmerci/planning-documents` (Agent Skill)
- Install (CLI): `npx skillmds@latest add rcmerci/planning-documents`
- Raw SKILL.md: https://api.skillmd.com/api/skills/rcmerci/planning-documents/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: rcmerci (https://skillmd.com/u/rcmerci)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/rcmerci/planning-documents

---


# 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:

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

Use the next available three-digit number.