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.mddocs/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.
More from rcmerci/skills
clojure-paren-repair
Repair unbalanced parentheses, brackets, and braces in Clojure, ClojureScript, and EDN files. Use when you encounter delimiter mismatch syntax errors after editing .clj, .cljs, .cljc, or .edn files, or on clojure syntax errors.
3clojure-babashka-cli
Turn Clojure functions into CLIs with babashka.cli. Use when working with command-line argument parsing, building CLIs, subcommand dispatching, option validation, or creating tools with babashka/clojure.
3writing clojure docstrings
Guidelines for writing effective Clojure docstrings with markdown formatting, wikilinks, code examples, and tables. Always use this skill when writing or reviewing docstrings in Clojure code, or when asked about docstring formatting and style. Triggers on (1) writing new functions/vars/namespaces with docstrings, (2) updating existing docstrings, (3) questions about docstring best practices, (4) reviewing code with docstrings.
3test-driven development (tdd)
Use when implementing any feature or bugfix, before writing implementation code - write the test first, watch it fail, write minimal code to pass; ensures tests actually verify behavior by requiring failure first
3improve-skill
Analyze coding agent session transcripts to improve existing skills or create new ones. Use when asked to improve a skill based on a session, or extract a new skill from session history.
2code-simplify
This skill should be used when the user asks to "simplify code", "clean up code", "refactor for clarity", "reduce complexity", "improve readability", "make this easier to maintain", or asks to simplify recently modified code.
2