Skip to content

Intermediate guide (teams and real projects)

Tutorial A guided lesson. Follow it start to finish and you will have built something.

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.

Run repeatable sessions with traceability and low rework.

  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.
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.
Implement only tasks from the active spec.
Before coding, confirm approved spec and consistent plan.
After changes, update history.md and bitacora.
Generate PROJECT_LOG entry and handoff with:
current state, pending items, blockers, exact next step.
Also verify if specs/INDEX.md status needs update.
  • One active spec per session.
  • No undocumented scope changes.
  • Mandatory handoff when work is pending.
Terminal window
./scripts/validate-sdd.sh . --strict
./scripts/check-sdd-gate.sh .