Spec-Kit Feature Requirements¶

This document defines all requirements for tracking spec-kit functionality within the canary system. Each requirement represents a distinct feature or capability that should be tracked with CANARY tokens.

Core Workflow Commands (REQ-SK-100 Series)¶

REQ-SK-101: Constitution Command¶

Feature: /speckit.constitution command implementation Aspect: CLI Description: Create or update project governing principles and development guidelines. Establishes immutable architectural principles that guide all development.

Key Capabilities: - Parse and validate constitution documents - Enforce constitutional compliance checks - Support for nine articles of development - Amendment tracking and version control

REQ-SK-102: Specify Command¶

Feature: /speckit.specify command implementation Aspect: CLI Description: Define what to build through structured requirements and user stories. Focuses on WHAT and WHY, not HOW.

Key Capabilities: - Automatic feature numbering - Branch creation from feature description - Template-based specification generation - Ambiguity marking with [NEEDS CLARIFICATION] - User story prioritization (P1, P2, P3) - Independent testability validation

REQ-SK-103: Clarify Command¶

Feature: /speckit.clarify command implementation Aspect: CLI Description: Structured clarification workflow for underspecified requirements. Sequential, coverage-based questioning.

Key Capabilities: - Identify ambiguous requirements - Generate clarification questions - Record answers in Clarifications section - Validate requirement completeness

REQ-SK-104: Plan Command¶

Feature: /speckit.plan command implementation Aspect: CLI Description: Create technical implementation plans with chosen tech stack. Converts business requirements to technical architecture.

Key Capabilities: - Specification analysis and interpretation - Constitutional compliance validation - Technical translation from requirements - Generate data models, API contracts, quickstart guides - Research document generation - Phase gate enforcement

REQ-SK-105: Tasks Command¶

Feature: /speckit.tasks command implementation Aspect: CLI Description: Generate actionable task lists from implementation plan. Supports parallel execution and dependency management.

Key Capabilities: - Parse plan.md and design documents - Derive tasks from contracts and entities - Mark independent tasks with [P] for parallelization - Output executable tasks.md - Task ordering by dependencies - Checkpoint validation per user story

REQ-SK-106: Implement Command¶

Feature: /speckit.implement command implementation Aspect: CLI Description: Execute all tasks to build feature according to plan. Orchestrates the implementation workflow.

Key Capabilities: - Validate prerequisites (constitution, spec, plan, tasks) - Parse and execute task breakdown - Respect dependencies and parallel markers - Follow TDD approach - Progress tracking and error handling

REQ-SK-107: Analyze Command¶

Feature: /speckit.analyze command implementation Aspect: CLI Description: Cross-artifact consistency and coverage analysis. Validates alignment between spec, plan, and tasks.

Key Capabilities: - Check consistency across artifacts - Identify coverage gaps - Validate requirement traceability - Detect contradictions and ambiguities

REQ-SK-108: Checklist Command¶

Feature: /speckit.checklist command implementation Aspect: CLI Description: Generate custom quality checklists that validate requirements completeness, clarity, and consistency.

Key Capabilities: - Requirement completeness validation - Clarity checking - Consistency verification - Custom checklist generation

CLI Tool Features (REQ-SK-200 Series)¶

REQ-SK-201: Specify CLI Init¶

Feature: specify init command Aspect: CLI Description: Bootstrap new projects with spec-kit framework.

Key Capabilities: - Project initialization with templates - AI agent selection and configuration - Git repository setup - Directory structure creation - Script variant selection (bash/PowerShell) - Force merge for existing directories

REQ-SK-202: Specify CLI Check¶

Feature: specify check command Aspect: CLI Description: Verify installed tools and prerequisites.

Key Capabilities: - Check for required tools (git, claude, gemini, etc.) - Validate AI agent installations - Report tool availability status - Provide installation URLs

REQ-SK-203: Agent Detection¶

Feature: AI agent detection and configuration Aspect: Core Description: Automatic detection and configuration of supported AI agents.

Key Capabilities: - Support for 14+ AI agents - Agent-specific command file generation - Directory structure per agent conventions - Argument pattern mapping

Template System (REQ-SK-300 Series)¶

REQ-SK-301: Spec Template¶

Feature: Feature specification template Aspect: Templates Description: Structured template for creating feature specifications.

Key Capabilities: - User scenarios with priorities - Acceptance criteria (Given-When-Then) - Functional requirements enumeration - Key entity definitions - Success criteria measurement - Edge case documentation

REQ-SK-302: Plan Template¶

Feature: Implementation plan template Aspect: Templates Description: Structured template for technical implementation plans.

Key Capabilities: - Technical context definition - Constitution check gates - Project structure specification - Complexity tracking - Phase-based implementation - File creation ordering

REQ-SK-303: Tasks Template¶

Feature: Tasks breakdown template Aspect: Templates Description: Template for generating actionable task lists.

Key Capabilities: - Task organization by user story - Dependency tracking - Parallel execution markers - File path specifications - TDD structure support - Checkpoint validation

REQ-SK-304: Checklist Template¶

Feature: Quality checklist template Aspect: Templates Description: Template for quality assurance checklists.

Key Capabilities: - Requirement completeness checks - Clarity validation - Consistency verification - Testability assessment

REQ-SK-305: Constitution Template¶

Feature: Constitutional framework template Aspect: Templates Description: Template for project constitution documents.

Key Capabilities: - Nine articles structure - Amendment process - Complexity tracking - Principle enforcement

REQ-SK-306: Agent File Template¶

Feature: Agent-specific file generation Aspect: Templates Description: Templates for generating agent command files.

Key Capabilities: - Markdown format (Claude, Cursor, Copilot, etc.) - TOML format (Gemini, Qwen) - Argument pattern substitution - Script path replacement

Constitutional Framework (REQ-SK-400 Series)¶

REQ-SK-401: Library-First Principle¶

Feature: Article I enforcement Aspect: Constitution Description: Enforce library-first architecture principle.

Key Capabilities: - Validate features as standalone libraries - Prevent direct application implementation - Enforce modular design - Check library boundaries

REQ-SK-402: CLI Interface Mandate¶

Feature: Article II enforcement Aspect: Constitution Description: Enforce CLI interface for all libraries.

Key Capabilities: - Validate text input/output - Check JSON format support - Ensure observability - Verify testability

REQ-SK-403: Test-First Imperative¶

Feature: Article III enforcement Aspect: Constitution Description: Enforce strict TDD workflow.

Key Capabilities: - Validate tests before implementation - Check test approval - Verify red phase (failing tests) - Enforce green phase (passing implementation)

REQ-SK-407: Simplicity Gate¶

Feature: Article VII enforcement Aspect: Constitution Description: Enforce simplicity and minimal project structure.

Key Capabilities: - Limit to 3 projects initially - Require justification for additional projects - Prevent future-proofing - Track complexity

REQ-SK-408: Anti-Abstraction Gate¶

Feature: Article VIII enforcement Aspect: Constitution Description: Combat over-engineering through anti-abstraction checks.

Key Capabilities: - Enforce framework trust - Prevent unnecessary wrappers - Single model representation - Justify abstraction layers

REQ-SK-409: Integration-First Testing¶

Feature: Article IX enforcement Aspect: Constitution Description: Prioritize integration tests over unit tests.

Key Capabilities: - Prefer real databases over mocks - Use actual service instances - Mandate contract tests - Validate realistic environments

Script Automation (REQ-SK-500 Series)¶

REQ-SK-501: Feature Creation Script¶

Feature: create-new-feature script Aspect: Automation Description: Automated feature branch and directory creation.

Key Capabilities: - Feature numbering - Branch creation - Directory setup - Template copying

REQ-SK-502: Plan Setup Script¶

Feature: setup-plan script Aspect: Automation Description: Initialize planning artifacts.

Key Capabilities: - Plan document creation - Research document setup - Contract directory structure - Data model initialization

REQ-SK-503: Agent Context Update¶

Feature: update-agent-context script Aspect: Automation Description: Update agent-specific context files.

Key Capabilities: - Agent file detection - Context merging - Multi-agent support (bash/PowerShell) - Auto-detection mode

REQ-SK-504: Prerequisites Check¶

Feature: check-prerequisites script Aspect: Automation Description: Validate required tools and dependencies.

Key Capabilities: - Tool availability checking - Version validation - Installation guidance - Dependency verification

Agent Support (REQ-SK-600 Series)¶

REQ-SK-601: Claude Code Support¶

Feature: Claude Code agent integration Aspect: Agent Description: Full support for Anthropic's Claude Code CLI.

Key Capabilities: - .claude/commands/ structure - Markdown command format - claude CLI detection - $ARGUMENTS pattern

REQ-SK-602: GitHub Copilot Support¶

Feature: GitHub Copilot agent integration Aspect: Agent Description: Full support for GitHub Copilot in VS Code.

Key Capabilities: - .github/prompts/ structure - Markdown format - IDE-based integration - Prompt file generation

REQ-SK-603: Gemini CLI Support¶

Feature: Gemini CLI agent integration Aspect: Agent Description: Full support for Google's Gemini CLI.

Key Capabilities: - .gemini/commands/ structure - TOML command format - gemini CLI detection - {{args}} pattern

REQ-SK-604: Cursor Support¶

Feature: Cursor agent integration Aspect: Agent Description: Full support for Cursor CLI.

Key Capabilities: - .cursor/commands/ structure - Markdown format - cursor-agent CLI detection - Command file generation

REQ-SK-605: Multi-Agent Support¶

Feature: Support for 14+ AI agents Aspect: Core Description: Unified support for multiple AI coding agents.

Key Capabilities: - Windsurf, Qwen, opencode, Codex - Kilo Code, Auggie CLI, Roo Code - CodeBuddy CLI, Amazon Q Developer - Agent-specific conventions - Format adaptation

Documentation System (REQ-SK-700 Series)¶

REQ-SK-701: Quickstart Guide¶

Feature: Quickstart documentation generation Aspect: Documentation Description: Generate quickstart guides for features.

Key Capabilities: - Key validation scenarios - Setup instructions - Testing procedures - Example usage

REQ-SK-702: Research Documentation¶

Feature: Research document generation Aspect: Documentation Description: Capture technical research and decisions.

Key Capabilities: - Library compatibility research - Performance benchmarking - Security considerations - Technology rationale

REQ-SK-703: Data Model Documentation¶

Feature: Data model documentation Aspect: Documentation Description: Generate data model specifications.

Key Capabilities: - Entity definitions - Relationship mapping - Schema documentation - Constraint specification

REQ-SK-704: API Contract Documentation¶

Feature: API contract generation Aspect: Documentation Description: Generate and maintain API contracts.

Key Capabilities: - OpenAPI/Swagger specs - REST endpoint definitions - GraphQL schemas - WebSocket event specs

Quality Assurance (REQ-SK-800 Series)¶

REQ-SK-801: Ambiguity Detection¶

Feature: Requirement ambiguity detection Aspect: Quality Description: Detect and flag ambiguous requirements.

Key Capabilities: - Pattern matching for vague terms - [NEEDS CLARIFICATION] markers - Suggestion generation - Completeness validation

REQ-SK-802: Consistency Validation¶

Feature: Cross-artifact consistency checking Aspect: Quality Description: Validate consistency across spec, plan, and tasks.

Key Capabilities: - Requirement traceability - Conflict detection - Coverage analysis - Gap identification

REQ-SK-803: Coverage Analysis¶

Feature: Feature coverage analysis Aspect: Quality Description: Analyze test and implementation coverage.

Key Capabilities: - User story coverage - Acceptance criteria tracking - Test coverage mapping - Implementation completeness

REQ-SK-804: Staleness Detection¶

Feature: Documentation staleness detection Aspect: Quality Description: Identify outdated specifications and plans.

Key Capabilities: - Timestamp tracking - Change detection - Update recommendations - Sync status reporting

Package Management (REQ-SK-900 Series)¶

REQ-SK-901: Release Packages¶

Feature: Agent-specific release packages Aspect: Distribution Description: Generate release packages for each AI agent.

Key Capabilities: - Per-agent ZIP creation - Script variant packaging (bash/PowerShell) - Template bundling - Version management

REQ-SK-902: GitHub Release¶

Feature: GitHub release automation Aspect: Distribution Description: Automate GitHub release creation.

Key Capabilities: - Release tagging - Package uploading - Changelog generation - Asset management

REQ-SK-903: Version Management¶

Feature: Semantic versioning Aspect: Core Description: Manage semantic versions across toolkit.

Key Capabilities: - Version bumping - CHANGELOG.md updates - pyproject.toml sync - Breaking change tracking

Summary¶

This requirements catalog defines 46 distinct features across 10 major categories:

Core Workflow Commands (8 features): Constitution, Specify, Clarify, Plan, Tasks, Implement, Analyze, Checklist
CLI Tool Features (3 features): Init, Check, Agent Detection
Template System (6 features): Spec, Plan, Tasks, Checklist, Constitution, Agent Files
Constitutional Framework (5 features): Library-First, CLI Mandate, Test-First, Simplicity Gate, Anti-Abstraction, Integration-First
Script Automation (4 features): Feature Creation, Plan Setup, Agent Context, Prerequisites Check
Agent Support (5 features): Claude Code, Copilot, Gemini, Cursor, Multi-Agent
Documentation System (4 features): Quickstart, Research, Data Model, API Contracts
Quality Assurance (4 features): Ambiguity Detection, Consistency Validation, Coverage Analysis, Staleness Detection
Package Management (3 features): Release Packages, GitHub Release, Version Management
Additional Features (4 features): Git Integration, Environment Variables, Error Handling, Extensibility

Each requirement should be tracked with CANARY tokens throughout the spec-kit codebase to monitor implementation status, test coverage, and maintenance.