How harudeenm/spec-kit works
Spec Kit is a CLI and agent-facing toolkit for structured software work. Its setup path is terminal user → project initialization → agent integration; after setup, users invoke independent agent-chat processes: spec-driven development, bug fixing, or idea assessment. The CLI also manages extensions, presets, workflows, artifacts, and role-based bundles. The README documents these capabilities, while the sampled source confirms CLI registration, initialization dependencies, integration abstractions, and workflow execution. Some process content and extension behavior are not shown in the excerpts, so those links are documented at subsystem level rather than inferred from unsampled implementation.
Main entry points: __init__.py Specify CLI · base.py Integration lifecycle · init.py Project initialization · _commands.py Integration commands
Components 19
CLI and setup
- Specify CLI
src/specify_cli/__init__.py - Project initialization
src/specify_cli/commands/init.py
Agent integration
- Agent configuration
src/specify_cli/_agent_config.py - Integration commands
src/specify_cli/integrations/_commands.py - Integration lifecycle
src/specify_cli/integrations/base.py - Agent integrations
src/specify_cli/integrations/manifest.py - Agent command registrar
src/specify_cli/agents.py
Processes and customization
- Spec-driven development
src/specify_cli/workflows/engine.py - Bug-fixing process
src/specify_cli/extensions/__init__.py - Idea assessment
src/specify_cli/extensions/__init__.py - Extension manager
src/specify_cli/extensions/__init__.py - Preset manager
src/specify_cli/presets/__init__.py - Workflow overlays
src/specify_cli/workflows/overlays/composer.py - Artifact catalog
src/specify_cli/artifacts/catalog.py
Bundles
- Bundle commands
src/specify_cli/commands/bundle/__init__.py - Bundle installation
src/specify_cli/bundler/services/installer.py
Shared services
- Agent runtime events
src/specify_cli/events.py - CLI presentation
src/specify_cli/_console.py
Other components
- Project user
Connections 21
- Project user → Specify CLI: runs
README.md - Specify CLI → Project initialization: registers
src/specify_cli/__init__.py - Project user → Project initialization: creates project
README.md - Project initialization → Integration commands: configures integration
src/specify_cli/commands/init.py - Integration commands → Integration lifecycle: uses lifecycle
- Integration lifecycle → Agent integrations: tracks files
src/specify_cli/integrations/base.py - Integration lifecycle → Agent runtime events: installs hooks
src/specify_cli/events.py - Integration lifecycle → Agent command registrar: registers commands
src/specify_cli/integrations/base.py - Specify CLI → Extension manager: registers commands
src/specify_cli/__init__.py - Specify CLI → Preset manager: registers commands
src/specify_cli/__init__.py - Specify CLI → Artifact catalog: registers commands
src/specify_cli/__init__.py - Specify CLI → Bundle commands: registers commands
src/specify_cli/__init__.py - Bundle commands → Bundle installation: installs bundles
src/specify_cli/commands/bundle/__init__.py - Project user → Spec-driven development: invokes skill
README.md - Project user → Bug-fixing process: invokes skills
README.md - Project user → Idea assessment: invokes skills
README.md - Project user → Extension manager: installs extensions
README.md - Project user → Preset manager: customizes process
README.md - Spec-driven development → Workflow overlays: supports overlays
- Project initialization → Agent configuration: reads configuration
src/specify_cli/commands/init.py - Specify CLI → CLI presentation: uses presentation
src/specify_cli/__init__.py