[plan] Set up spec-kit directory structure and templates

[github-actions]

Objective

Initialize the .specify/ directory structure with all necessary templates, scripts, and configuration files to enable Spec-Driven Development in this repository.

Context

Spec-kit uses a specific directory structure under .specify/ that contains:

• Project constitution and memory
• Bash scripts for workflow automation
• Templates for specifications, plans, and tasks
• Agent context files

Reference: spec-kit templates

Implementation Steps

1. Create .specify/ directory structure:

   .specify/
   ├── memory/
   │   └── constitution.md
   ├── scripts/
   │   ├── check-prerequisites.sh
   │   ├── common.sh
   │   ├── create-new-feature.sh
   │   ├── setup-plan.sh
   │   └── update-agent-context.sh
   ├── specs/
   │   └── .gitkeep
   └── templates/
       ├── plan-template.md
       ├── spec-template.md
       └── tasks-template.md
   

2. Adapt scripts from spec-kit bash scripts:

   • Download and adapt check-prerequisites.sh for gh-aw environment
   • Download and adapt common.sh with gh-aw specific paths
   • Download and adapt create-new-feature.sh for feature branch management
   • Download and adapt setup-plan.sh for plan initialization
   • Download and adapt update-agent-context.sh for agent instructions

3. Create template files:

   • spec-template.md - Feature specification template
   • plan-template.md - Technical implementation plan template
   • tasks-template.md - Task breakdown template

4. Create initial constitution:

   • Create .specify/memory/constitution.md with gh-aw project principles
   • Include references to existing AGENTS.md and CONTRIBUTING.md
   • Define governance for technical decisions in gh-aw context

5. Make scripts executable:

   chmod +x .specify/scripts/*.sh

Files to Create/Modify

• Create: .specify/memory/constitution.md
• Create: .specify/scripts/check-prerequisites.sh
• Create: .specify/scripts/common.sh
• Create: .specify/scripts/create-new-feature.sh
• Create: .specify/scripts/setup-plan.sh
• Create: .specify/scripts/update-agent-context.sh
• Create: .specify/templates/spec-template.md
• Create: .specify/templates/plan-template.md
• Create: .specify/templates/tasks-template.md
• Create: .specify/specs/.gitkeep

Acceptance Criteria

• .specify/ directory exists with proper structure
• All scripts are executable and adapted for gh-aw
• Templates match spec-kit format but reference gh-aw specifics
• Constitution reflects gh-aw project principles
• Scripts reference correct paths and tools in gh-aw context

References

• Spec-kit scripts
• Spec-kit templates
  Related to [plan] Integrate GitHub spec-kit for Spec-Driven Development workflow #5767

AI generated by Plan Command for #5761