Skip to content

02-workflow.md

Latest commit

 

History

History
114 lines (77 loc) · 2.73 KB

02-workflow.md

File metadata and controls

114 lines (77 loc) · 2.73 KB

🧭 Workflow

Back to index

🌍 Language pair / Par de idioma

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

Quick view

Step Action Outcome
1 Define idea Clear project direction
2 Create specification Defined scope
3 Plan and split tasks Structured execution
4 Implement Real deliverable
5 Update logbook Full traceability
6 Refine Continuous improvement

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
Loading

Step 1: Define 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 required files ✅

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

Step 4: Execute real 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

💡 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

flowchart LR
  A["Project idea"] --> B["Spec approved"]
  B --> C["Plan aligned"]
  C --> D["Tasks prioritized"]
  D --> E["Implementation"]
  E --> F["Validation + Logbook"]
Loading