How sukanth/spec-kit works
Spec Kit is a CLI toolkit that prepares projects for AI coding agents and supplies structured development processes plus composable extensions. The user initializes a project with an agent integration, then invokes agent-facing commands to produce specifications, plans, tasks, implementation, and convergence; bug-fixing and idea-assessment processes are independent optional extensions. The repository also supports reusable presets, workflows and overlays, custom workflow steps, bundles, catalogs, authentication, artifact inspection, MCP, and lifecycle events. Edges use README capability/workflow statements or SOURCE INDEX references; unsampled subsystem internals are represented by their existing directories.
Main entry points: base.py Agent integrations · specify_cli/__init__.py Specify CLI · integrations/__init__.py Agent registry · engine.py Workflow engine
Components 29
Project and agents
- Specify CLI
src/specify_cli/__init__.py - Init options
src/specify_cli/_init_options.py - Agent integrations
src/specify_cli/integrations/base.py - Agent registry
src/specify_cli/integrations/__init__.py - Command registration
src/specify_cli/agents.py - Integration state
src/specify_cli/integration_state.py - Shared infrastructure
src/specify_cli/shared_infra.py - CLI presentation
src/specify_cli/_console.py - Integration helpers
src/specify_cli/integrations/_helpers.py - Integration installer
src/specify_cli/integrations/installer.py - Integration manifest
src/specify_cli/integrations/manifest.py - Invocation styles
src/specify_cli/_invocation_style.py - CLI utilities
src/specify_cli/_utils.py
Processes and workflows
- Core templates
src/specify_cli/_assets.py - Workflow engine
src/specify_cli/workflows/engine.py - Workflow steps
src/specify_cli/workflows/step - Workflow expressions
src/specify_cli/workflows/expressions/engine.py
Customization
- Extensions
src/specify_cli/extensions/__init__.py - Presets
src/specify_cli/presets/_manager.py - Preset commands
src/specify_cli/presets/_manager_commands.py - Workflow overlays
src/specify_cli/workflows/overlay
Components and catalogs
- Bundles
src/specify_cli/bundles - Catalogs
src/specify_cli/catalogs.py - Catalog authentication
src/specify_cli/authentication - Artifact inventory
src/specify_cli/artifacts/catalog.py - Safe downloads
src/specify_cli/_download_security.py
Runtime access
- MCP server
src/specify_cli/mcp_server/server.py - Agent events
src/specify_cli/events/__init__.py
Other components
- Developer
Connections 31
- Developer → Specify CLI: runs commands
README.md - Specify CLI → Init options: records setup
src/specify_cli/__init__.py - Specify CLI → Agent registry: selects integration
src/specify_cli/__init__.py - Agent registry → Agent integrations: resolves adapter
src/specify_cli/integrations/__init__.py - Agent integrations → Command registration: registers commands
src/specify_cli/integrations/base.py - Command registration → Preset commands: used for registration
src/specify_cli/presets/_manager_commands.py - Developer → Agent integrations: chooses agent
README.md - Agent integrations → Core templates: installs SDD templates
- Developer → Workflow engine: invokes process
README.md - Workflow engine → Workflow steps: runs steps
src/specify_cli/workflows/engine.py - Workflow engine → Workflow expressions: evaluates expressions
src/specify_cli/workflows/expressions/engine.py - Developer → Extensions: installs process
README.md - Extensions → Command registration: registers commands
src/specify_cli/extensions/__init__.py - Developer → Presets: adapts methodology
README.md - Presets → Preset commands: reconciles commands
src/specify_cli/presets/_manager.py - Developer → Workflow overlays: customizes workflows
README.md - Developer → Bundles: installs setup
README.md - Developer → Catalogs: discovers components
README.md - Catalogs → Catalog authentication: supports private access
README.md - Developer → Artifact inventory: inspects artifacts
README.md - Developer → MCP server: connects MCP client
- Agent integrations → Agent events: installs lifecycle hooks
src/specify_cli/events/__init__.py - Specify CLI → CLI presentation: renders CLI output
src/specify_cli/__init__.py - Catalogs → Safe downloads: validates downloads
- Agent registry → Integration manifest: validates catalog data
src/specify_cli/integrations/__init__.py - Agent integrations → Integration helpers: uses helpers
- Agent integrations → Integration installer: loads trusted adapters
src/specify_cli/integrations/installer.py - Agent integrations → Invocation styles: formats invocation
src/specify_cli/integrations/base.py - Specify CLI → CLI utilities: uses utilities
src/specify_cli/__init__.py - Specify CLI → Shared infrastructure: uses shared services
src/specify_cli/__init__.py - Agent integrations → Integration state: tracks active integration