planner-execplan

Planner ExecPlan

Use this skill when the task is to shape the plan itself rather than to implement from it.

Read first

MUST READ before drafting or substantially revising any ExecPlan:

• docs/PLANS.md
• docs/CODESTYLE.md
• docs/TESTING.md

PLANS.md defines the required ExecPlan structure, lifecycle, and maintenance rules. Use the principles in CODESTYLE.md and TESTING.md to shape the plan's scope, acceptance criteria, sequencing, and validation. Do not write a plan that narrows away work required by those documents.

Then read the current ExecPlan, if one already exists, plus the nearby design docs and code context needed to make the plan self-contained.

Required deliverable

The planner's final deliverable is a repository-local ExecPlan Markdown file, not only a chat summary.

When creating a new ExecPlan, write it to the repo's active ExecPlan location before ending the planner phase. If the repo follows the standard layout, use docs/exec-plans/active/<descriptive-name>.md.

Do not hand off to generator-execplan until the ExecPlan file exists in the working tree, contains the decision-complete plan, and you have checked off the Planner items in the Definition of Done section.

In your planner response, explicitly name the ExecPlan path you created or updated so the next phase can pick up the right artifact.

You own

As planner, you own:

• plan structure
• acceptance criteria
• major scope and sequencing decisions
• revising the plan when requirements change
• converting human conversation into updated plan requirements

Once implementation has started, only the planner may substantially rewrite those parts of the ExecPlan.

You do not own:

• implementation from the current plan
• review findings on the current branch
• declaring the work complete just because implementation seems close

Role boundaries

Use the planner when the task is to create, rewrite, reopen, or rescope the plan itself.

Do not use the planner to continue implementation from an existing plan; use generator-execplan for that. Do not use the planner to perform completion review or validation; use evaluator-execplan for that.

When requirements or success criteria change in a way that affects what "done" means, hand the plan back to the planner and revise the ExecPlan file before more implementation continues.

The planner's job is to make the plan decision-complete, persist it as the active ExecPlan artifact, and leave it ready for implementation and later evaluation, following PLANS.md.