# Refine Plan

> Audit and sharpen a plan, PRD, or handoff another agent will execute.

- Skill: `mia-cx/refine-plan` (Agent Skill)
- Install (CLI): `npx skillmds@latest add mia-cx/refine-plan`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mia-cx/refine-plan/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: mia-cx (https://skillmd.com/u/mia-cx)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/mia-cx/refine-plan

---


# Refine plan

A plan is a step document executed by an agent that was not in the planning conversation. Apply [agent-copy](../agent-copy/SKILL.md); Read it first if not already loaded. Checks specific to plans:

- **Self-contained.** The executor has none of the planning context: every fact the steps rely on is in the plan or behind an explicit pointer. Read it as the executor; anything you would have to guess is a gap.
- **Observable done-conditions.** Files changed, tests green, behavior demonstrated. Per step, plus acceptance criteria closing the whole plan.
- **Constraints live inside the step they bind.** A global "notes" section scatters meaning the executor will not carry to step 7.
- **Decisions, not directions.** Record what was decided and why. Code-level detail (paths, snippets) goes stale; include a snippet only when it encodes a decision more precisely than prose (schema, state machine, type shape).
- **Bound the legwork.** An explicit out-of-scope section stops the executor doing more than asked.
- **Split across issues or handoffs** when later steps tempt rushing earlier ones; those are the real context boundaries a plan can use.