1. Setup Environment

Install and configure Spec-Kit Plus for spec-driven development with AI agents

Goal: Install Spec Kit Plus and create a new project to understand SDD loop run without friction.

Inputs

  • Git installed and configured with your preferred editor
  • Python 3.10+ or the latest Astral uv runtime (used by uvx)
  • Setup any coding agent of your choice (Qwen Code, Gemini CLI, Claude Code, Cursor, GitHub Copilot, Roo, etc.)

Actions

Quick start with SpecifyPlus CLI

  1. Install SpecifyPlus (persistent option recommended)
# From PyPI (recommended)
pip install specifyplus
# or with uv tools
uv tool install specifyplus

Alternative (one-off):

uvx specifyplus --help
uvx specifyplus init <PROJECT_NAME>
# or
uvx sp init <PROJECT_NAME>
  1. Run the readiness checks
specifyplus --help
# or
sp --help
specifyplus check
# or
sp check
  1. Bootstrap your project
specifyplus init <PROJECT_NAME>
# or
sp init <PROJECT_NAME>
  1. Follow the slash-command sequence inside your coding agent (Copilot, Claude Code, Cursor, Gemini CLI, etc.).

Inspect the generated .github/ and .specify/ folders, then delete the sandbox once you understand the layout.

Slash commands (Spec Kit Plus 2025)

CommandPurpose
/constitutionCreate or update project principles and guardrails.
/specifyCapture the “what” and “why” of the feature or product.
/clarifyResolve ambiguities before planning; must run before /plan unless explicitly skipped.
/planProduce the technical approach, stack choices, and quickstart.
/tasksBreak the plan into actionable units of work.
/analyzeCheck cross-artifact coverage and highlight gaps after /tasks.
/implementExecute tasks in sequence with automated guardrails.
/phrTo explicitly create a prompt history record.
/adrTo create or update an architecture decision record.

Deliverables

  • A fresh repository ready for Spec Kit
  • Verified uvx runner capable of invoking specifyplus

References