Skip to content

a5c-ai/babysitter / library/methodologies/pilot-shell/skills/spec-driven-development

spec-driven-development

Unverified

Specification creation and management for the Pilot Shell methodology. Covers semantic search, clarifying questions, structured spec generation, and iterative refinement.

  • Search for files and code related to the task description
  • Identify existing patterns that the spec should follow
  • Map the impact area of proposed changes
  • Generate SEARCH-CONTEXT.md with findings

2. Clarifying Question Resolution

  • Identify ambiguities in the task description
  • Generate targeted clarifying questions
  • Resolve assumptions with explicit choices
  • Document decisions for traceability

3. Spec Generation

  • Structure specs with: title, goals, tasks, acceptance criteria
  • Decompose into atomic, testable tasks
  • Define dependency graphs between tasks
  • Include rollback plans and risk assessments
  • Generate SPEC.md document

4. Iterative Refinement

  • Accept plan-reviewer feedback
  • Apply revision requests by severity
  • Refine task decomposition
  • Update acceptance criteria

Spec Structure

# Specification: [Title]

## Goals
- [ ] Goal 1 with measurable outcome

## Tasks
### Task 1: [Description]
- **Acceptance Criteria**: ...
- **Test Strategy**: RED->GREEN->REFACTOR
- **Complexity**: low/medium/high
- **Dependencies**: [task-ids]

## Assumptions
- Assumption 1 (validated: yes/no)

## Risks
- Risk 1: Mitigation strategy
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: 195kUpdated Claude CodeCodexVerifiedInstall
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: 192kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 192kUpdated Claude CodeCodexVerifiedInstall
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: 192kUpdated Claude CodeCodexVerifiedInstall