Workflow skill
Dev Planning Skill
Create and reconcile implementation plans from requirements and design.
On this page
Install command
AI DevKit installs its built-in skills as one curated set. Run this once to install dev-planning with the rest of the built-in workflow skills.
npx ai-devkit@latest skill add --built-inWhat it does
Use dev-planning when you need a concrete implementation plan, task breakdown, blocker capture, or progress reconciliation before code changes.
When to use it
- Turn a design into implementation tasks
- Mark progress and capture blockers
- Keep feature plans aligned with reality
Supported agents
- Claude Code
- Codex
- Cursor
- opencode
The SKILL.md file
This is what your agent reads when the skill runs. View it on GitHub (opens in a new tab)
Run planning creation and reconciliation for configured AI docs features. Before changing docs, propose the concrete plan for this phase and wait for user approval unless the user already approved the exact phase plan.
Phase Contract#
- Run
npx ai-devkit@latest lintbefore phase work. - If working on a named feature, run
npx ai-devkit@latest lint --feature <name>. - Read existing configured planning, implementation, and testing docs before changes. Resolve paths through
lint --featureinstead of assumingdocs/ai. - Keep task creation and updates traceable to requirements, design, testing scenarios, completed work, blockers, or newly discovered scope.
- If parent
dev-lifecycleestablished usable task tracing, emit planning phase, progress, blocker/scope, and next-step events pertask.
Create Initial Plan#
Use for Phase 4 after requirements, design, and initial testing docs exist.
- Run
npx ai-devkit@latest lint --feature <name>and identify the planning doc path it validates. Ifdocs init-featurejust ran, use the returned planning path as authoritative. - Read requirements, design, and testing docs for the feature.
- Convert goals, user stories, design components, API/data changes, migration needs, and testing scenarios into implementation tasks.
- Group tasks by milestone or logical sequence.
- For each task, include outcome, dependencies, validation evidence, and related testing scenarios.
- Verify every test-plan scenario has at least one implementation task.
- Add risks, blockers, sequencing notes, and likely follow-up checks.
- Update the planning doc with the initial ordered task list.
- If task tracing is available, record plan progress and next implementation step per
task.
Next: dev-implementation.
Update Planning#
Use for Phase 6. Auto-trigger this phase after completing any task in dev-implementation.
- Run
npx ai-devkit@latest lint --feature <name>and reconcile the planning doc path it validates. If manual path resolution is unavoidable, first resolve.ai-devkit.jsonpaths.docs, falling back todocs/ai. - If continuing from implementation, carry forward existing context. Otherwise ask for feature name, completed tasks, new tasks, blockers, and planning doc path.
- Review existing milestones, sequencing, dependencies, and outstanding tasks.
- Reconcile each task: mark status as done, in-progress, blocked, or not started; note scope changes; record blockers; capture skipped or added tasks.
- Update the planning doc with the current status checklist.
- Suggest the next 2-3 actionable tasks, risky areas, and coordination needed.
- If task tracing is available, record completed/blocked/new tasks, blockers, and next action per
task. - Write a summary paragraph for the planning doc covering progress, risks, upcoming focus, and scope changes.
Next: if tasks remain, return to dev-implementation. If all done, run implementation verification before testing and review.