Generates detailed specs from rough plans via adaptive interviews covering scope, tech, UX, risks, operations. Reviews specs for completeness, consistency, clarity, edge cases.
From plan-interviewnpx claudepluginhub secondsky/claude-skills --plugin plan-interviewThis skill uses the workspace's default tool permissions.
references/example-spec.mdreferences/interview-techniques.mdreferences/phase-1-clarifications.mdreferences/phase-2-technical.mdreferences/phase-3-ux.mdreferences/phase-4-risks.mdImplements structured self-debugging workflow for AI agent failures: capture errors, diagnose patterns like loops or context overflow, apply contained recoveries, and generate introspection reports.
Compares coding agents like Claude Code and Aider on custom YAML-defined codebase tasks using git worktrees, measuring pass rate, cost, time, and consistency.
Designs and optimizes AI agent action spaces, tool definitions, observation formats, error recovery, and context for higher task completion rates.
Transform rough plans into comprehensive, implementation-ready specifications through adaptive, structured interviews.
/plan-interview:interview [plan-file]Adaptive interview that calibrates depth based on plan complexity:
| Complexity | Signals | Questions |
|---|---|---|
| Simple | Single feature, clear scope | 10-15 |
| Moderate | Multi-component, some integrations | 18-23 |
| Complex | Cross-system, many stakeholders | 22-28 |
Usage:
/plan-interview:interview docs/feature-plan.md
# Output: docs/feature-plan-spec.md
spec-reviewerAutonomous quality analysis of specifications across 4 dimensions:
Triggers when you say "review my spec" or "check specification quality".
Core Principle: Depth over breadth. Better to deeply understand critical aspects than superficially cover everything.
Key Techniques:
Generated specs include:
Load these for deeper guidance during interviews:
references/phase-1-clarifications.md - Foundations questions and pitfallsreferences/phase-2-technical.md - Architecture discussion patternsreferences/phase-3-ux.md - Persona development, UX patternsreferences/phase-4-risks.md - Risk assessment frameworksreferences/interview-techniques.md - Cross-cutting interview skillsreferences/example-spec.md - Annotated high-quality spec example