Skip to content

08-github-spec-kit-integration.md

Latest commit

 

History

History
133 lines (92 loc) · 3.42 KB

08-github-spec-kit-integration.md

File metadata and controls

133 lines (92 loc) · 3.42 KB
Raw

🤖 GitHub Spec Kit integration

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:

This template recommends GitHub Spec Kit as the main workflow engine.

Quick map

Phase Command Purpose
1 /speckit.constitution Define project principles
2 /speckit.specify Define what to build
3 /speckit.plan Define how to build
4 /speckit.tasks Generate executable tasks
5 /speckit.implement Execute implementation

Visual flow

flowchart LR
  A["Constitution"] --> B["Specification"]
  B --> C["Plan"]
  C --> D["Tasks"]
  D --> E["Implementation"]
  E --> F["Logbook + Refinement"]
Loading

Recommended installation

Persistent installation

uv tool install specify-cli --from git+https://github.com/github/spec-kit.git

One-time usage

uvx --from git+https://github.com/github/spec-kit.git specify init <PROJECT_NAME>

Initialize in existing project

specify init . --ai codex
# or
specify init --here --ai codex

One-time command alternative:

uvx --from git+https://github.com/github/spec-kit.git specify init . --ai codex

Recommended initialization with this template

If this template is already available locally, you can bootstrap a project and initialize Spec Kit in one step:

./scripts/init-project-with-spec-kit.sh /path/project codex

How it fits this template

  • idea/ defines global project intent.
  • specs/ stores numbered specifications.
  • bitacora/ stores real execution trace.

Practical recommendation

After Spec Kit commands, always update:

  • specs/INDEX.md
  • active spec history.md
  • bitacora/global/PROJECT_LOG.md
  • bitacora/diaria/
  • bitacora/handoffs/ when pending work exists

Then validate:

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

💡 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