sdd

Orchestrates a spec-driven development pipeline from brainstorm through validated task execution.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/phm-aguiar/test_documentacao --skill sdd-phm-aguiar
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sdd
Source: https://github.com/phm-aguiar/test_documentacao/tree/main/.claude/skills/sdd
Command: npx skills add https://github.com/phm-aguiar/test_documentacao --skill sdd-phm-aguiar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It removes the chaos of ad-hoc feature development by enforcing a structured Spec-Driven Development pipeline: every feature goes through brainstorm, specification, architectural planning, DAG-based task generation, and coordinated execution with validation gates. ## Core Features & Use Cases - Nine pipeline modes: brainstorm (interview to spec.md), explore_tech (stack detection to tech.md), init_repo (SDD scaffolding), plan (plan.md with ADRs), tasks (DAG-based tasks.md), coordinate (LATTE protocol multi-agent execution), validate (compliance audit), refactor (artifact normalization), and wiki-enforce (CLAUDE.md trigger table). - LATTE coordination protocol: dispatches researcher, analyst, and executor agents in sliding windows of up to 3 workers, with heartbeat-based reassignment, retry limits, and DAG frontier tracking. - Hard gates and guardrails: blocks implementation before spec approval, validates DAGs for cycles and file conflicts, and enforces idempotent, confirmation-based file writes. - Use Case: You have a new feature idea. Run brainstorm to produce an approved spec.md, generate plan.md and tasks.md, then execute the tasks via coordinated agents that mark each task complete only after build verification. ## Quick Start Ask the assistant to start an SDD brainstorm for your new feature idea so it can interview you and produce an approved spec.md.

Frequently Asked Questions about sdd

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I start a new feature with spec-driven development?▼

Use the brainstorm mode, which interviews you one question at a time about purpose, scope, and success criteria, then generates a spec.md under specs/features/. Implementation is blocked until you explicitly approve the spec.

How does the LATTE protocol coordinate multiple agents?▼

LATTE dispatches researcher, analyst, and executor agents from the task DAG frontier in batches of up to 3 workers. Completed tasks are verified by build success, marked closed in tasks.md, and dependent tasks are then dispatched.

What happens if a task fails during coordinated execution?▼

A worker silent for 4 rounds is reassigned with enriched context, up to 3 attempts. After 3 failures on the same task, its sub-tree is blocked and the issue is escalated to the human.

Can I generate tasks.md before the spec is approved?▼

No. The tasks mode has a hard gate that checks for 'Aprovado: true' in spec.md and aborts immediately if the spec is not approved. The same gate applies to the coordinate execution mode.

Does the validate mode modify any repository files?▼

No. Validate is strictly read-only. It audits .github/memory/, specs/ structure, feature artifacts, and CLAUDE.md, then emits a PASS/FAIL/WARN report with suggested actions.

When should I not delegate a task to a worker agent?▼

Skip delegation when the task's files already exist and the build passes. In that case the lead marks the task closed directly in tasks.md without dispatching an agent.