AI agent skill · by @a5c-ai

Spec Creation

Feature specification creation from codebase research. Produces requirements, acceptance criteria, architecture decisions, implementation plans, and risk analysis.

Archived 2026-10-23 · Source updated 2026-09-16 · License: MIT. Check the original repository for the latest version.

SKILL.md instructions

- Identify existing patterns and conventions
- Map dependencies and integration points
- Review existing tests for testing patterns
- Document technical constraints

## Specification Components

### Scope and Non-Goals
Clear boundaries on what the feature does and does not include.

### Functional Requirements
Detailed requirements with unique identifiers for tracking.

### Acceptance Criteria
Testable, measurable criteria for each requirement.

### Architecture Decisions
Decision records with rationale and alternatives considered.

### Implementation Plan
Phased approach ordered by dependency, not priority.

### Risk Analysis
Identified risks with probability, impact, and mitigation strategies.

### API Contracts and Data Models
Interface definitions and data model schemas.

### Test Strategy
Mapping of unit, integration, and E2E tests to requirements.

## Output

Specifications are saved to `docs/specs/{feature}.md` for reference by the execution workflow.

## When to Use

- `/spec:create [feature]` slash command
- Before starting a new feature implementation
- When planning complex multi-module changes

## Processes Used By

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