Skip to main content

Welcome to SpecifyX Documentation

SpecifyX is an enhanced Python CLI tool for specification-driven development that helps developers create specifications, implementation plans, and manage project workflows with AI assistant integration.

Getting Started​

Choose your path to get started with SpecifyX:

Quick Start (5 minutes)​

Comprehensive Guides​

Reference Documentation​

What is Specification-Driven Development?​

Specification-Driven Development flips the script on traditional software development. Instead of code being king, specifications become executable, directly generating working implementations through AI assistants.

The 6-Phase Process​

  1. Specify - Define what to build using /specify commands
  2. Clarify - Resolve ambiguities using /clarify commands
  3. Plan - Design how to build it using /plan commands
  4. Tasks - Break down into actionable tasks using /tasks commands
  5. Analyze - Validate consistency using /analyze commands
  6. Implement - Execute tasks using /implement or /guide commands

Key Features​

  • AI-Native Workflow: Seamless integration with Claude, Gemini, and Copilot
  • Specification-First: Define requirements before implementation
  • Template System: Powerful Jinja2-based templating with AI-aware content
  • Project Management: Initialize projects with structured workflows
  • Auto-Synced Documentation: Keep documentation alongside code

Quick Installation​

# Using uv (recommended)
uv tool install specifyx

# Using pipx
pipx install specifyx

# Using pip
pip install specifyx

Quick Usage​

# Initialize a new project
specifyx init my-awesome-project

# Check system requirements
specifyx check

# Use AI assistant commands
/specify Build a user authentication system
/plan Use Python with FastAPI and SQLite
/tasks Break down into actionable development tasks

Next Steps​

Ready to get started? Begin with the Quick Start Guide to see SpecifyX in action, or dive deeper with the Development Workflow for comprehensive guidance.