Guía rápida para no programadores

Tutorial Una lección guiada. Síguela de principio a fin y habrás construido algo.

🌍 Par de idioma / Language pair

Español: 13-guia-rapida-no-programadores.md
English: ../en/13-quick-guide-non-programmers.md

[!IMPORTANT] ¿Dónde están estos scripts? Depende de cómo instalaste SDD:

Si añadiste la carpeta spec/ a un proyecto que ya tenías (lo normal), van con spec/ delante: ./spec/scripts/new-spec.sh …

Si creaste el proyecto desde cero con la plantilla, van tal cual: ./scripts/new-spec.sh …

Ejecútalos desde la carpeta principal de tu proyecto, en una terminal.

🗣️ Prompt amigable (copiar y pegar)

Usando https://github.com/juanklagos/spec-driven-development-template, crea todo lo necesario para llevar a cabo mi proyecto de principio a fin.
Mi proyecto es: [explica tu proyecto en lenguaje simple].
Guíame por nivel y no omitas especificación, plan, tareas, bitácora y validación.

Para quién es:

Para quien arranca en SDD y no quiere pelearse con nada técnico todavía.

Objetivo

Completar un ciclo limpio:

idea definida
primera spec creada
primera entrada de bitácora
validaciones ejecutadas

Pasos

Completa idea/IDEA_GENERAL.md con lenguaje simple.
Crea la primera spec:

./scripts/new-spec.sh "mi-primera-feature" "Responsable"

Completa en specs/001-.../:

spec.md
plan.md
tasks.md
history.md

Valida:

./scripts/validate-sdd.sh . --strict
./scripts/check-sdd-gate.sh .

Registra sesión en bitacora/global/PROJECT_LOG.md.

Pack de prompts (Principiante)

Prompt A: completar idea

Actúa como coach SDD para principiantes.
Ayúdame a completar idea/IDEA_GENERAL.md con lenguaje simple.
Haz una pregunta corta a la vez.
No asumas información faltante.

Prompt B: crear primera spec

Con base en idea/IDEA_GENERAL.md, crea specs/001-... con:
spec.md, plan.md, tasks.md, history.md.
Usa redacción clara y evita siglas sin explicar.
No implementes código.

Prompt C: revisión antes de implementar

Revisa consistencia entre spec.md, plan.md y tasks.md.
Lista brechas y correcciones exactas antes de implementar.

Reglas obligatorias

No código sin spec.md aprobada + plan.md consistente.
Si cambia la idea, primero actualiza documentación.

Más prompts

Próximo paso

docs/es/14-guia-intermedia.md