tibursocampos/agent-dev-toolkit / core/skills/sdd-spec
sdd-spec
VerifiedCreate a PRD for a new feature or change (agent PRD .md; language per LANGUAGE.md + preferences under features/). Feeds sdd-plan. Use when creating a spec or invoking /sdd-spec.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 21.9 KB |
| reference.md | markdown | 1.5 KB |
| references/challenge-vagueness.md | markdown | 2.8 KB |
| references/command.md | markdown | 3.4 KB |
| references/english-override.md | markdown | 327 B |
| references/filename-numbering.md | markdown | 668 B |
| references/product-docs-language.md | markdown | 236 B |
| references/quality-checklist.md | markdown | 2.0 KB |
| references/req-tracking.md | markdown | 1.6 KB |
| references/selective-retrieval.md | markdown | 400 B |
| references/storage-gitignore.md | markdown | 954 B |
| references/template-usage.md | markdown | 720 B |
| references/validate-change.md | markdown | 475 B |
| references/validate-prd.md | markdown | 873 B |
references/command.md
View on GitHub# sdd-spec — command playbook
**Load after Step -1 gates.** Ordered step discovery without dumping `SKILL.md` Process. Load **one** section file per step (`SKILL-REFERENCE-RETRIEVAL.md`).
| Step | Action | Lazy section / contract |
|------|--------|-------------------------|
| -1b | Caveman Lite when active | `CAVEMAN.md` |
| -1 | Pipeline + STORAGE; `invocation_context`; load provenance | `PIPELINE.md`, `STORAGE.md`, `INVOCATION-CONTEXTS.md`, `CONTRACT-PROVENANCE.md` |
| 0 | Workspace; detect stack; resolve NNN / US01 default | `STORAGE.md` |
| 1 | Requirements (gap questions in question blocks of ≤5; selective retrieval; required siblings STOP) | `SELECTIVE-RETRIEVAL.md`; `PIPELINE.md` § Prior |
| 2–5 | Confirm repo, explore, clarify (question blocks of ≤5), technical analysis | — |
| 5.5 | Challenge vagueness + **product depth** + REQ (`agreed` vs `invented`); no how/code | `references/challenge-vagueness.md`, `references/req-tracking.md`; lazy `feature-altitude.md`, `invest-and-story-quality.md`, `gherkin-budget.md`, `clarify-depth.md`, `product-evidence-lite.md`; `anti-task-shatter.md` only if titles task-shaped; `CONTRACT-PROVENANCE.md` |
| 6.75 | Approve PRD content (**sim** / **ajustar** / **cancelar**). Approval does not authorize a write | `PIPELINE.md` |
| 6.8 | Open-question gate on story siblings (STORY, required ANALYSIS / ARCH / SEC). Ask every open question in question blocks of ≤5. **sim** does not close `open_question` | `readiness-severity.md` § Open-question gate |
| 6.9 | Confirm before write (**sim**) | `PIPELINE.md` |
| 7 | Write PRD only when step 6.9 is clear (Agent + sim); portable paths | `references/template-usage.md`, `references/filename-numbering.md`, `references/storage-gitignore.md` |
| 7.5 | Structural validate (`validate-prd`; CHANGE when brownfield) | `references/validate-prd.md`, `references/validate-change.md` |
## Stage table
Standard, state keys, glyphs, and label map: `LIVE-STAGE-TABLE.md` (§ sdd-spec). Columns, in order: `stage`, `status`, `weight`, `what_happened`. Headers and state labels follow the user chat language; glyphs are the ASCII ones from the standard.
| Stage | Weight | Covers step |
|-------|--------|-------------|
| Resolve workspace and requirements | Medium | -1, 0, 1 |
| Explore the repo | High | 2-5 (repo exploration, technical analysis) |
| Clarify (question blocks) | Medium | 2-5 (question blocks) |
| Draft | High | 5.5 |
| Review | High | 5.5 (vagueness, product depth, REQ contract) |
| Content gate | Low | 6.75, 6.8 |
| Preview | Low | 6.9 (summary before the write question) |
| Write gate | Low | 6.9 (write confirmation) |
| Persist | Low | 7, 7.5 |
You must render the full table at each of these points:
1. When the flow starts: first row `in_progress`, the rest `pending`.
2. Before each gate (each question to the operator).
3. After each gate answer.
4. On each row state change.
5. On a blocker or failure: stop the redraw at `blocked`, name the cause, and do not present a successful table.
6. At close or handoff.
Completeness: always render the full table with every row. Do not summarize rows, show only the changed row, or omit completed rows. `skipped` requires a reason in `what_happened`.
Gate answers use **sim** / **ajustar** / **cancelar**. Do not save this table in the PRD.
Quality: `references/quality-checklist.md`. Language: `references/product-docs-language.md`, `references/english-override.md`.
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: 468k | Updated | Claude CodeCodex | Unverified | 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: 321k | 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: 321k | 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: 321k | Updated | Claude CodeCodex | Verified | Install |