Onboarding de 30 minutos

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

---

🌍 Par de idioma / Language pair

• Español: 23-onboarding-30-minutos.md
• English: ../en/23-30-minute-onboarding.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)

Úsalo si no eres técnico y quieres que la IA lo integre todo y te vaya guiando:

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].

Si mi proyecto es nuevo, inicialízalo con este template y GitHub Spec Kit.
Si mi proyecto ya existe, adáptalo a idea/specs/bitacora sin romper el comportamiento actual.
Guíame paso a paso según mi nivel (principiante/intermedio/avanzado), con lenguaje claro.
No omitas especificación, plan, tareas, traza de refinamiento, bitácora y validación.

Media hora, un reloj y este orden: al final tienes un proyecto SDD que pasa validación.

⏱️ Plan minuto a minuto

Minutos 0–5: Orientación

1. Lee QUICKSTART.md — te da la visión completa en 1 página
2. Revisa AI_START_HERE.md si vas a usar un asistente de IA
3. Decide tu modo:
   • ¿Proyecto nuevo? → Continúa con el Paso 4 abajo
   • ¿Proyecto existente? → Usa el prompt “adaptar proyecto” de QUICKSTART.md

Minutos 5–12: Define tu idea

4. Abre idea/IDEA_GENERAL.md
5. Llena estas secciones (no pienses demasiado — podrás refinar después):
   • Project Name — ¿cómo se llama?
   • Problem to solve — 2 oraciones máximo
   • Main Goal — el resultado más importante
   • Initial Scope (MVP) — 3–5 features como bullet points
   • Out of Scope — al menos 2 cosas que NO vas a construir

[!TIP] Atajo IA: pega tu template de IDEA_GENERAL.md a ChatGPT/Claude con: “Ayúdame a llenar esto para un proyecto que [describe tu idea en 1 oración]”

Minutos 12–22: Crea la primera especificación

6. Ejecuta: ./scripts/new-spec.sh "mi-feature" "TuNombre"
7. Abre el specs/001-mi-feature/spec.md generado y llena:
   • Description — ¿qué hace esta feature?
   • Requirements — lista numerada, sé específico
   • Acceptance criteria — “La feature está lista cuando…”
   • Out of scope — qué NO incluye esta spec específica
8. Abre plan.md y escribe 3–5 oraciones sobre tu enfoque técnico
9. Abre tasks.md y descompón el trabajo en 5–10 checkboxes

Minutos 22–27: Inicializa la bitácora

10. Abre bitacora/global/PROJECT_LOG.md
11. Agrega tu primera entrada de sesión:

    ### [YYYY-MM-DD HH:MM] Sesión 1
    - Objetivo: Configurar estructura SDD y definir primera spec
    - Trabajo realizado: Llenado IDEA_GENERAL.md, creada spec 001
    - Decisiones: [lo que decidiste sobre el alcance]
    - Próximo paso: Revisar spec, iniciar implementación
    - Responsable: TuNombre

Minutos 27–30: Valida y guarda

12. Ejecuta: ./scripts/validate-sdd.sh . --strict
13. Corrige lo que salte (si seguiste los pasos, no debería salir nada)
14. Haz commit de tu trabajo:

    git add -A
    git commit -m "chore: inicializar estructura SDD con primera spec"

🎯 Qué tienes al terminar

La visión del proyecto queda en idea/IDEA_GENERAL.md. La primera especificación, con su plan técnico y su desglose de tareas, en specs/001-*/ (spec.md, plan.md, tasks.md). La primera entrada de sesión, en bitacora/global/PROJECT_LOG.md. Y validate-sdd.sh pasa sin errores, que es la parte que importa: la estructura no está solo escrita, está verificada.

🤖 Prompt para onboarding asistido por IA

Si quieres que la IA te guíe interactivamente:

Usando https://github.com/juanklagos/spec-driven-development-template como guía principal,
ayúdame a completar un onboarding de 30 minutos para mi proyecto: [DESCRIBE TU PROYECTO].
Guíame paso a paso: definición de idea, creación de primera spec, y configuración de bitácora.
Quiero outputs concretos en cada etapa. No saltes ningún paso.