Workflow

Explanation Background and reasoning. No instructions here.

---

🌍 Language pair / Par de idioma

• English: 02-workflow.md
• Español: ../es/02-flujo-de-trabajo.md

🗣️ 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.

[!TIP] For startup instructions and prompts, use:

• AI_START_HERE.md
• Prompt matrix
• Validated prompt bank

Quick view

Step	Action	What it writes
1	Define idea	idea/IDEA_GENERAL.md
2	Create specification	specs/NNN-name/spec.md
3	Plan and split tasks	plan.md + tasks.md
4	Implement	code, plus the ticked boxes in tasks.md
5	Update logbook	bitacora/diaria/YYYY-MM-DD.md
6	Refine	the spec’s history.md

Visual flow

flowchart LR
  A["Idea"] --> B["Specification"]
  B --> C["Plan"]
  C --> D["Tasks"]
  D --> E["Implementation"]
  E --> F["Logbook"]
  F --> G["Refinement"]
  G --> B

Step 1: Define the project idea

Complete idea/IDEA_GENERAL.md.

Step 2: Create a specification

Create a numbered folder in specs/.

Example:

• specs/001-authentication/

Step 3: Complete the required files

• spec.md
• plan.md
• tasks.md
• research.md
• history.md
• contracts/ when needed

Step 4: Do the work

Implement tasks from tasks.md.

Step 5: Record what happened

Update:

• bitacora/global/PROJECT_LOG.md
• bitacora/diaria/YYYY-MM-DD.md
• bitacora/handoffs/ when pending work remains

Step 6: Refine

If ideas or requirements change, follow:

• docs/en/11-continuous-refinement.md