sdd-plan
Skill0 starsChanged 37 days agoMITView on GitHub
Use when planning delivery phases, milestones, dependencies, or exit gates, or when designing or reviewing a software project's repository layout, directory and package structure, and physical ownership of code, tests, and documentation. Produces or revises PLAN.md, FEATURE-PLAN.md, layout.md, and focused children before executable TASKS or FEATURE-TASKS are derived.
5 other projects use a version of this.
Adopted by
Most recently taken up by
- mariano-aguero/spec-driven-development-skilltheir own version, first seen Nov 8, 2026
- ad1code/sdd-harnesstheir own version, first seen Nov 1, 2026
- monaccode/astromesh-sddtheir own version, first seen Oct 20, 2026
- felipefontoura/pi-sdd-kittheir own version, first seen Oct 13, 2026
- khangpqvn/SDDADDtheir own version, first seen Sep 29, 2026
Other versions5 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 5
- felipefontoura/pi-sdd-kit★ 36same name
- khangpqvn/SDDADD★ 12same name
- mariano-aguero/spec-driven-development-skill★ 11same name
- ad1code/sdd-harness★ 4same name
- monaccode/astromesh-sdd★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository14 other files it gives its agents.
- sdd-conventionsSkill
- sdd-designSkill
- sdd-docsSkill
- sdd-forgeSkill
- sdd-implementSkill
- sdd-integrate-featureSkill
- sdd-manageSkill
- sdd-orientSkill
- sdd-reportSkill
- sdd-specifySkill
- sdd-steerSkill
- sdd-tasksSkill
- sdd-tddSkill
- sdd-verifySkill
The file
We split this skill into the rules it gives an agent
1 rule. 0 are common, 1 is distinctive, and 0 are very specific to this project.
0
Common
Most of the 4 edited versions we read keep these.
1
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 8
Default to an early meaningful end-to-end MVP followed by small, testable capability increments.
“Common” is measured: kept by at least 6 in 10 of the 4 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Plan delivery and physical layout
Default to an early meaningful end-to-end MVP followed by small, testable capability increments; preserve the complete intended design and SPEC. Use the delivery reference for scope, prerequisite exceptions, and exit evidence.
Choose the requested work and load only its references. A request for complete delivery planning develops both PLAN and layout when physical ownership needs to be established; a focused request to review or revise one document does not automatically authorize rewriting the other.
Apply sdd-conventions' Development-document QC reference (skills/sdd-conventions/references/development-document-qc.md, bundled dependency). Authoring includes scoped review, correction/recheck and the adjacent report before dependent progression; pure review does not authorize corrections.
| Work | Load |
| Prepare both delivery strategy and physical placement for task derivation | delivery plan and physical layout |
| Define or revise delivery strategy, phases, milestones, dependencies, or a scoped feature plan | delivery plan |
| Define or revise physical ownership of implementation, tests, and documentation | physical layout |
| Review PLAN and layout consistency | review |
Before authoring, read the relevant PROJECT, ARCHITECTURE, DECOMPOSITION, SPEC, their focused children, and any existing PLAN and layout. Inspect relevant code, tests, and packaging for existing projects; distinguish observed placement from intended placement. If inputs conflict or a required behavioral or architectural decision is unresolved, identify its owner instead of silently settling it in PLAN or layout. Start at the requested operation when its inputs are established.
Read-only review can proceed without changing files. Creating, revising, or removing project documents requires sdd-manage to coordinate the user's request and a current sdd-orient handoff establishing an eligible Git worktree, applicable instructions, target paths, and ownership of dirty changes. This skill does not perform orientation or authorize another workflow.
PLAN owns delivery strategy and boundary verification; layout owns physical placement and ownership. SPEC owns behavior and acceptance; design owns logical structure; TASKS and an active FEATURE-TASKS own their respective stable, ordered execution units and progress. Use sdd-conventions when assessing component or task boundaries, without incorporating its shared rules here. Neither PLAN nor layout is a task checklist, a progress journal, or permission to implement. The downstream task workflow consumes the accepted design, SPEC, PLAN, and layout together.
Incorporation of an accepted FEATURE-PLAN into main PLAN or layout belongs to sdd-integrate-feature. Direct plan or layout corrections remain in their owning authoring workflows.
At completion, report the strategy or placement established, affected phases or ownership boundaries, unresolved material decisions, and documents inspected or updated. Describe proposed work as planned, not implemented.
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.

