Plan

Decompose epic specifications into testable tasks with dependencies and acceptance criteria.

1|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/htxryan/claude-code-config-profiles --skill plan-htxryan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Plan
Source: https://github.com/htxryan/claude-code-config-profiles/tree/main/.agents/skills/compound/plan
Command: npx skills add https://github.com/htxryan/claude-code-config-profiles --skill plan-htxryan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a high-level feature specification into an actionable implementation plan is error-prone: tasks end up too large, acceptance criteria stay vague, dependencies get missed, and later review phases lack a clear definition of done. This Skill structures the planning phase so every epic becomes a set of small, verifiable, traceable tasks. ## Core Features & Use Cases - Task Decomposition: Breaks an epic (read via bd show) into 3-7 small, individually verifiable tasks with mapped dependencies and no circular references. - Acceptance Criteria Generation: Extracts testable criteria from EARS requirements and appends an Acceptance Criteria table to the epic description, with each requirement mapped to at least one criterion. - Verification Contract: Derives a per-epic definition of done (profile, surfaces, risks, required evidence such as test, lint, build) so review phases know exactly what evidence is required. - Research Integration: Searches memory (ca search, ca knowledge) and spawns analyst subagents to ground the plan in past decisions, ADRs, and codebase patterns. - Use Case: Given an epic describing a new CLI feature, produce beads tasks with dependencies, an AC table tracing each EARS requirement, a verification contract for the cli profile, and blocking review/compound gate tasks. ## Quick Start Ask the agent to plan the implementation of an epic by decomposing it into testable tasks with acceptance criteria and a verification contract.

Frequently Asked Questions about Plan

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I break a feature spec into implementation tasks?▼

Read the epic's EARS requirements, research existing patterns and ADRs, then decompose into 3-7 tasks small enough to verify individually. Define acceptance criteria per task, map dependencies, and create issues with bd create so each task traces back to a spec requirement.

What is a verification contract in sprint planning?▼

A verification contract is a per-epic definition of done listing the profile (webapp, api, cli, library, service), touched surfaces, risks, and required evidence such as tests, lint, and build. It is appended to the epic description so review phases know exactly what to check.

How do I write testable acceptance criteria from requirements?▼

Map each EARS requirement to at least one criterion row with an ID, source requirement, observable condition, and verification method such as unit test or integration test. Avoid vague adjectives like fast or good; every criterion must be objectively verifiable.

When should ambiguities be resolved during task planning?▼

Resolve ambiguities, conflicting constraints, and priority trade-offs before decomposing into tasks, using a direct user question when the choice materially changes the plan. Decomposing first leads to rework when assumptions prove wrong.

What are common mistakes when decomposing epics into tasks?▼

Common pitfalls include creating too many fine-grained tasks, vague acceptance criteria, missing dependencies, ignoring past architectural decisions in memory and ADRs, and skipping the acceptance criteria table or verification contract that later phases depend on.