Skip to main content
ClaudeWave
Skill1.3k repo starsupdated today

spec-execution

Spec-execution automates implementation of feature specifications through six sequential phases: coding the feature with documentation, writing comprehensive tests, conducting code review, iteratively improving until quality thresholds are met, creating atomic commits with descriptive messages, and generating progress reports. Use this skill after creating a specification file and when ready to systematically implement it with integrated quality validation.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/a5c-ai/babysitter /tmp/spec-execution && cp -r /tmp/spec-execution/library/methodologies/claudekit/skills/spec-execution ~/.claude/skills/spec-execution
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

# Spec Execution

## Overview

Executes a feature specification through 6 iterative phases with quality-gated convergence. Each phase builds on the previous, with improvement cycles triggered when quality falls below threshold.

## Six Phases

### Phase 1: Implementation
- Read specification for requirements and architecture
- Implement each requirement following project conventions
- Add type definitions and JSDoc documentation
- Implement error handling for all failure modes

### Phase 2: Test Writing
- Write unit tests for each module/function
- Write integration tests for API boundaries
- Cover all acceptance criteria from the specification
- Test edge cases and error paths

### Phase 3: Code Review
- Verify all requirements are implemented
- Check acceptance criteria are tested
- Review architecture adherence
- Assess code quality

### Phase 4: Iterative Improvement
- Address review findings
- Fix failing tests
- Resolve architecture deviations
- Re-verify quality (convergence loop, max 3 cycles)

### Phase 5: Atomic Commit
- Group changes into logical atomic commits
- Descriptive messages following project conventions
- Separate production, test, and config changes
- Include specification reference

### Phase 6: Progress Tracking
- Requirement completion percentage
- Test coverage summary
- Quality score report
- Remaining work identification

## Quality Gate

Quality threshold defaults to 80. If not met after max improvement cycles, a human breakpoint is triggered for review.

## When to Use

- `/spec:execute [file]` slash command
- After spec creation when ready to implement

## Processes Used By

- `claudekit-spec-workflow` (execute mode)