a5c-ai/babysitter / library/methodologies/claudekit/skills/spec-creation
spec-creation
VerifiedFeature specification creation from codebase research. Produces requirements, acceptance criteria, architecture decisions, implementation plans, and risk analysis.
SKILL.md
View on GitHub---
name: spec-creation
description: Feature specification creation from codebase research. Produces requirements, acceptance criteria, architecture decisions, implementation plans, and risk analysis.
allowed-tools: Read, Bash, Grep, Glob
graph:
domains: [domain:software-engineering]
skillAreas: [skill-area:agentic-loops, skill-area:orchestration-loop]
workflows: [workflow:feature-development]
topics: [topic:developer-experience]
roles: [role:tech-lead, role:backend-engineer]
---
- 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)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |