tibursocampos/agent-dev-toolkit / core/skills/sdd-plan
sdd-plan
VerifiedCreate a baby-step PLAN from an existing PRD (agent PLAN .md; language per LANGUAGE.md + preferences). Feeds sdd-develop. Use when creating a plan or invoking /sdd-plan.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 22.5 KB |
| reference.md | markdown | 1.6 KB |
| references/baby-step-sizing.md | markdown | 1.9 KB |
| references/challenge-vagueness.md | markdown | 1.4 KB |
| references/checklist-acquisition.md | markdown | 6.9 KB |
| references/command.md | markdown | 3.1 KB |
| references/filename-numbering.md | markdown | 715 B |
| references/plan-ledger.md | markdown | 1.1 KB |
| references/plan-magro.md | markdown | 2.0 KB |
| references/plan-update.md | markdown | 502 B |
| references/product-docs-language.md | markdown | 188 B |
| references/quality-checklist.md | markdown | 3.3 KB |
| references/selective-retrieval.md | markdown | 313 B |
| references/self-review.md | markdown | 5.0 KB |
| references/status-legend.md | markdown | 887 B |
| references/storage-gitignore.md | markdown | 543 B |
| references/template-usage.md | markdown | 3.0 KB |
| references/validate-plan.md | markdown | 584 B |
references/template-usage.md
View on GitHub## Template usage
1. `Read` `skills/_shared/templates/sdd/PLAN.md`.
2. Copy into the canonical PLAN path; remove instructional brackets.
3. Fill **Mapa REQ → passo** so every PRD `REQ-NNN` appears in ≥1 step.
4. Each step **Aceite** cites **REQ-NNN** and/or CA with verifiable outcomes (no vague language). Mark completed REQ coverage in develop via checked Aceite lines.
5. **`## Related` (REQ-009):** Keep the template Navigation block. Title exactly `## Related`. **MUST** include the source PRD portable path. After Write, refresh the PRD `## Related` so it cites this PLAN (classic mutual cite when both exist). Cite STORY / FEATURE / CONTINUITY only when on-disk. **Omit-if-absent** — never stub siblings solely for links (`STORAGE.md` § Navigation block).
6. Immediately before the Mermaid graph, add a two-column index in the same order as the ledger: step id, objective.
7. Every test row has a precondition, an action, an assertion, and whether it is required or conditional.
8. Use BDD as the language for observable behavior and acceptance; it does not
require an automated test for each scenario or a new test in every step. Use
TDD selectively when test-first feedback provides distinct evidence for the
behavior, risk, or boundary. For material behavior, apply
`skills/_shared/sdd-artifacts/SEMANTIC-SUFFICIENCY.md` rather than duplicating
its criteria: cite source paths and sections or symbols actually read,
identify what role the evidence plays, distinguish demonstrated behavior
from proposal or gap, and state the proof
limit. Trace source/producer, selection/route, receiver, and effect only as
relevant. A present receiver does not prove a publisher or integration; do
not imply messaging where the flow has none. Include a material negative
route when it bounds the behavior.
The PLAN records each behavior (or a justified group sharing evidence and a
proof boundary) against REQ/CA, existing coverage/evidence, primary proof
boundary, disposition (reuse, add/change, defer with reason, limit/dependency,
or no new check with a reason), owner, and create/execute checkpoint. Add
validation only for distinct missing evidence or composition value. Any
additional proof cites distinct behavior or composition value; do not repeat the same validation at
every layer; cover lower layers for their own behavior and composition where it adds evidence.
Do not repeat a check per
file or step without a distinct proof boundary. Follow the
consumer's established runner, libraries, doubles/mocks, and test structure.
Deferred checks stay pending, have a reason, limit, dependency, owner, and
checkpoint, and never pass or close intermediate acceptance; put them in
final consolidation only when they do not gate that step. Final
consolidation maps applicable acceptance criteria to tests/evidence,
preserves unique unit and unrelated smoke coverage, and removes only proven
redundancy. Keep the PLAN/US DoD open until required consolidation and
configured STATE/EVD validation pass.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 470k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |