Skip to content
SDD Template

🛠️ Intermediate guide (teams and real projects)

🌍 Language pair / Par de idioma

Section titled “🌍 Language pair / Par de idioma”

🗣️ Friendly prompt (copy/paste)

Section titled “🗣️ Friendly prompt (copy/paste)”
Using https://github.com/juanklagos/spec-driven-development-template, create everything needed to carry out my project end-to-end.
My project is: [describe your project in plain language].
Guide me step by step for my level and do not skip specification, plan, tasks, logbook, and validation.

Who is this for:

  • You already use SDD basics and need consistent team execution.

Goal

Section titled “Goal”

Run repeatable sessions with traceability and low rework.

Standard session flow

Section titled “Standard session flow”
  1. Read context (idea, INDEX, latest handoff).
  2. Select one active spec.
  3. Execute only in-scope tasks.
  4. Update history.md, INDEX.md (if needed), PROJECT_LOG.md.
  5. Validate and close with next exact step.

Prompt pack (Intermediate)

Section titled “Prompt pack (Intermediate)”

Prompt A: Start session cleanly

Section titled “Prompt A: Start session cleanly”
Read idea/IDEA_GENERAL.md, specs/INDEX.md, and latest handoff.
Select one active spec and propose a 5-step session plan.
Block any out-of-scope work.

Prompt B: Controlled implementation

Section titled “Prompt B: Controlled implementation”
Implement only tasks from the active spec.
Before coding, confirm approved spec and consistent plan.
After changes, update history.md and bitacora.

Prompt C: Session close + handoff

Section titled “Prompt C: Session close + handoff”
Generate PROJECT_LOG entry and handoff with:
current state, pending items, blockers, exact next step.
Also verify if specs/INDEX.md status needs update.

Team controls

Section titled “Team controls”
  • One active spec per session.
  • No undocumented scope changes.
  • Mandatory handoff when work is pending.

Validation

Section titled “Validation”
Terminal window
./scripts/validate-sdd.sh . --strict
./scripts/check-sdd-gate.sh .

More prompts

Section titled “More prompts”

Next step

Section titled “Next step”

💡 Quick tips

Section titled “💡 Quick tips”
  • Start from a simple one-paragraph project description.
  • Ask the AI to confirm the active spec before coding.
  • Close every session with validation and a clear next step.

📊 Visual flow

Section titled “📊 Visual flow”
flowchart LR
  A["Project idea"] --> B["Spec approved"]
  B --> C["Plan aligned"]
  C --> D["Tasks prioritized"]
  D --> E["Implementation"]
  E --> F["Validation + Logbook"]