Skip to content
SDD Template

30-minute onboarding

🌍 Language pair / Par de idioma

Section titled “🌍 Language pair / Par de idioma”

🗣️ Friendly prompt (copy/paste)

Section titled “🗣️ Friendly prompt (copy/paste)”

Use this when you are not technical and want the AI to do setup + guidance end-to-end:

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


If my project is new, initialize it with this template and GitHub Spec Kit.
If my project already exists, adapt it to idea/specs/bitacora without breaking current behavior.
Guide me step by step for my level (beginner/intermediate/advanced), using simple language.
Do not skip specification, plan, tasks, refinement trace, logbook, and validation.

Get from zero to a validated SDD project in 30 minutes. This is your guided speed-run.

⏱️ Minute-by-minute plan

Section titled “⏱️ Minute-by-minute plan”

🕐 Minutes 0–5: Orientation

Section titled “🕐 Minutes 0–5: Orientation”
  1. Read QUICKSTART.md — this gives you the full picture in 1 page
  2. Skim AI_START_HERE.md if you’re using an AI assistant
  3. Decide your mode:
    • New project? → Continue with Step 1 below
    • Existing project? → Use adapt existing project prompt from QUICKSTART.md

🕐 Minutes 5–12: Define your idea

Section titled “🕐 Minutes 5–12: Define your idea”
  1. Open idea/IDEA_GENERAL.md
  2. Fill out these sections (don’t overthink — you’ll refine later):
    • Project Name — what’s it called?
    • Problem to solve — 2 sentences max
    • Main Goal — the single most important outcome
    • Initial Scope (MVP) — 3–5 features as bullet points
    • Out of Scope — at least 2 things you will NOT build

[!TIP] AI shortcut: paste your IDEA_GENERAL.md template to ChatGPT/Claude with: “Help me fill this out for a project that [describe your idea in 1 sentence]”

🕐 Minutes 12–22: Create first specification

Section titled “🕐 Minutes 12–22: Create first specification”
  1. Run: ./scripts/new-spec.sh "my-feature" "YourName"
  2. Open the generated specs/001-my-feature/spec.md and fill:
    • Description — what does this feature do?
    • Requirements — numbered list, be specific
    • Acceptance criteria — “The feature is done when…”
    • Out of scope — what this specific spec does NOT include
  3. Open plan.md and write 3–5 sentences about your technical approach
  4. Open tasks.md and break down the work into 5–10 checkboxes

🕐 Minutes 22–27: Initialize logbook

Section titled “🕐 Minutes 22–27: Initialize logbook”
  1. Open bitacora/global/PROJECT_LOG.md
  2. Add your first session entry: 
    ### [YYYY-MM-DD HH:MM] Session 1
    - Goal: Set up SDD structure and define first spec
    - Work completed: Filled IDEA_GENERAL.md, created spec 001
    - Decisions: [what you decided about scope]
    - Next step: Review spec, start implementation
    - Owner: YourName

🕐 Minutes 27–30: Validate and celebrate

Section titled “🕐 Minutes 27–30: Validate and celebrate”
  1. Run: ./scripts/validate-sdd.sh . --strict
  2. Fix any errors (there shouldn’t be any if you followed the steps)
  3. Commit your work:
    Terminal window
    git add -A
    git commit -m "chore: initialize SDD structure with first spec"

🎯 Your result after 30 minutes

Section titled “🎯 Your result after 30 minutes”
What you have Where it lives
✅ Clear project vision idea/IDEA_GENERAL.md
✅ First specification specs/001-*/spec.md
✅ Technical plan specs/001-*/plan.md
✅ Task breakdown specs/001-*/tasks.md
✅ Session log entry bitacora/global/PROJECT_LOG.md
✅ Validated structure validate-sdd.sh passes

🤖 AI-assisted onboarding prompt

Section titled “🤖 AI-assisted onboarding prompt”

If you want the AI to guide you interactively:

Using https://github.com/juanklagos/spec-driven-development-template as the main guide,
help me complete a 30-minute onboarding for my project: [DESCRIBE YOUR PROJECT].
Walk me through each step: idea definition, first spec creation, and logbook setup.
I want concrete outputs at each stage. Do not skip any steps.

💡 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"]