Skip to content

Walkthrough (Fork Workflow)

This guide walks through the full fork workflow: Phase 0 followed by Spec‑Driven Development (SDD).

0) Install and Initialize

Install the forked CLI and initialize a project:

uv tool install specify-cli --from git+<https://github.com/nsalvacao/spec-kit.git>
specify init my-project --ai codex

Open the project folder and start your AI agent of choice.

Use strategic brainstorm when you need a deeper expansion pass before Phase 0:

/speckit.brainstorm

This command runs the 8-framework strategic brainstorm and generates .ideas/brainstorm-expansion.md.

Output: .ideas/brainstorm-expansion.md

Then transform strategy into an actionable roadmap:

/speckit.execution-plan

This command generates .ideas/execution-plan.md.

Output: .ideas/execution-plan.md

These artifacts complement (do not replace) Phase 0. Use them as context for IDEATE and downstream planning.

Phase 0 generates the artifacts that justify the project before specs are written.

  1. IDEATE

bash /speckit.ideate Generate 2–5 seed ideas and expand them using SCAMPER + HMW.

Output: .spec-kit/ideas_backlog.md

  1. SELECT

bash /speckit.select Score all ideas with AI-RICE and pick the top candidate.

Output: .spec-kit/idea_selection.md

  1. STRUCTURE

bash /speckit.structure Build the AI Vision Canvas and a concise Vision Brief.

Output: .spec-kit/ai_vision_canvas.md, .spec-kit/vision_brief.md

  1. VALIDATE

bash /speckit.validate Run Gate G0 checks and produce a decision report.

Output: .spec-kit/approvals/g0-validation-report.md

3) Establish Project Constitution

/speckit.constitution Create principles focused on code quality, testing standards, UX consistency, and performance.

Output: .specify/memory/constitution.md

4) Create the Specification

/speckit.specify Describe the feature requirements, user stories, and constraints.

Output: .specify/specs/<feature>/spec.md

/speckit.clarify Review and clarify missing details before planning.

6) Create the Plan

/speckit.plan Provide the tech stack and architecture choices.

Output: .specify/specs/<feature>/plan.md

7) Generate Tasks

/speckit.tasks

Output: .specify/specs/<feature>/tasks.md

/speckit.analyze

Checks cross‑artifact consistency before execution.

9) Implement

/speckit.implement

Executes tasks according to the plan.

10) Strategic Review (Pre-Launch Gate)

/speckit.strategic-review

Runs strategic readiness scoring and emits:

  • .ideas/evaluation-results.md
  • .ideas/launch-blockers.md (when score bands require blockers)

11) Amend (Post-Implementation)

/speckit.amend Describe the edge case, new scenario, or behavioral correction.

Applies a targeted amendment when an edge case or correction is discovered after implementation. Updates the spec, adds a failing test, then fixes the code without re-running the full pipeline.

12) Checklist

/speckit.checklist

Generates a quality checklist for the current feature.

13) Tasks to Issues

/speckit.taskstoissues

Converts tasks into GitHub issues for project tracking.

Troubleshooting Tips

  • If you are not using git branches, set:

bash export SPECIFY_FEATURE=001-your-feature

  • If an agent tool is not installed, run specify init --ignore-agent-tools.