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