spec-driven-development

SkillSearch

Lets your agent write and refine structured specs for software work using clarifying questions and search.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the spec-driven-development skill

About this capability

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

What this skill tells your AI

The instructions your AI receives, as published by a5c-ai/babysitter in library/methodologies/pilot-shell/skills/spec-driven-development/SKILL.md and read by ahel’s review.

  • 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

Signals

GitHub stars
2k
Forks
106
Last commit
Sep 2026
Hacker News mentions
3
Advanced
Catalog kind
skill
Gateway key
spec-driven-development
Source
github.com/a5c-ai/babysitter