a5c-ai/babysitter / library/methodologies/maestro/skills/specification-generation
specification-generation
VerifiedConvert requirements into structured technical specifications with architecture decisions
SKILL.md
View on GitHub---
name: specification-generation
description: Convert requirements into structured technical specifications with architecture decisions
allowed-tools: [Read, Write, Edit, 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]
---
# Specification Generation
## Capabilities
Transforms requirements from PM interviews into structured technical specifications. Includes technology stack selection, system architecture, data models, API contracts, and architecture decision records (ADRs).
## Tool Use Instructions
- Use **Read** to examine requirements documents and existing specs
- Use **Grep/Glob** to find related architectural patterns in the codebase
- Use **Write** to generate the technical specification document
- Use **Edit** to refine specs based on Architect feedback
## Process Integration
- Used in `maestro-orchestrator.js` Phase 2-3 (Architect Review, Tech Spec)
- Maps to tasks: `maestro-pm-spec-generation`, `maestro-architect-tech-spec`
- Agents: Product Manager (requirements spec), Architect (technical spec)
- Iterates with Architect feedback loop until approved
- Outputs feed into `story-decomposition` skill
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |