story-planner
Skill0 starsChanged 4 months agoMITView on GitHub
Houses scaffold_plan.py, scaffold_validation.py, verify_plan.py, and verify_validation.py used by the story-planner agent (prompts/story-planner.agent.md) to generate and validate per-story planning artifacts (US-NN-PLAN.md and US-NN-VALIDATION.md). This skill is not directly invocable; it is a script-housing skill that the story-planner agent shells out to.
In this repository29 other files it gives its agents.
- architectSkill
- brainstormingSkill
- concise-planningSkill
- context-engineerSkill
- data-analystSkill
- data-deprecation-analysisSkill
- data-engineeringSkill
- analystSkill
- detectiveSkill
- editorSkill
- inspectorSkill
- data-narrativeSkill
- data-scienceSkill
- excalidraw-diagramSkill
- genai-securitySkill
- guardianSkill
- holdout-validationSkill
- implementerSkill
- llm-app-patternsSkill
- llm-memSkill
- opsSkill
- prompt-librarySkill
- security-boundariesSkill
- story-masterSkill
- subagent-executionSkill
- systematic-debuggingSkill
- task-routingSkill
- thinkerSkill
- verification-before-completionSkill
The file
Files
story-planner
Script-housing skill for the story-planner agent. The story-planner agent (defined in
prompts/story-planner.agent.md) takes a single story from STORIES.md, scans the live
codebase for patterns, and produces a per-story implementation plan and validation map. This
skill provides the scaffolding and verification scripts that enforce the §3.2 and §3.4 schemas.
Scripts
| Script | Purpose |
| ./scripts/scaffold_plan.py | Generates a US-NN-PLAN.md skeleton with all required sections as TODO markers. Accepts --story-id US-XX. |
| ./scripts/scaffold_validation.py | Generates a US-NN-VALIDATION.md skeleton with empty Task Validation Matrix, AC Coverage Map, and Plan-Checker History table. Accepts --story-id US-XX. |
| ./scripts/verify_plan.py | Validates a US-NN-PLAN.md file against the §3.2 schema. Checks required sections, AC rows, task format, validate commands, and pattern references. Exits 0 on pass, 1 on failure. |
| ./scripts/verify_validation.py | Validates a US-NN-VALIDATION.md file against the §3.4 schema. Checks header, table columns, enum values, and Plan-Checker History. Exits 0 on pass, 1 on failure. |
Related Skills
- story-master - Produces the STORIES.md backlog that story-planner consumes on a per-story basis
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.