spec-creation-automation

What problem does it solve?

Technical specification creation is a time-consuming process for architects, involving manual data extraction, code discovery, and effort estimation. This skill automates 60-70% of this work, reducing spec creation time from 117 minutes to just 25-30 minutes.

Core Features & Use Cases

• Template Pre-filling: Automatically populates spec templates with data extracted from ROADMAP priorities (user stories, acceptance criteria, business value).
• Affected Code Discovery: Identifies files and components impacted by the priority, analyzes dependencies, and estimates complexity using the Code Index.
• Effort Estimation: Calculates effort estimates (design, implementation, testing) based on historical data and complexity scores.
• Draft Generation: Generates an 80% complete spec draft, allowing the architect to focus on critical architectural insights, design decisions, and trade-offs.
• Time Savings: Saves 92 minutes per spec, enabling a 3-6x increase in throughput.
• Use Case: An architect receives a request to create a spec for "PRIORITY 4.1." They invoke this skill, which automatically extracts priority data, discovers affected code, estimates effort, and generates an 80% complete draft, allowing the architect to quickly add their unique architectural insights.

Quick Start

# Step 1: Auto-extract priority data from ROADMAP
python scripts/template_populator.py --priority "PRIORITY 4.1"

# Step 2: Auto-discover affected code and estimate effort
python scripts/code_discoverer.py --priority "PRIORITY 4.1"
python scripts/effort_estimator.py --priority "PRIORITY 4.1" --complexity-score 45

# Step 3: Generate the 80% complete spec draft
python scripts/template_populator.py \
    --priority "PRIORITY 4.1" \
    --output docs/architecture/specs/SPEC-070-priority-4-1.md