multiphase-plan

Turns a goal into a phased implementation plan registered on a local Loop daemon.

1|Updated Nov 25, 2021
One-click install
npx skills add https://github.com/rstagi/dotfile --skill multiphase-plan-rstagi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: multiphase-plan
Source: https://github.com/rstagi/dotfile/tree/main/.claude/skills/multiphase-plan
Command: npx skills add https://github.com/rstagi/dotfile --skill multiphase-plan-rstagi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Large coding efforts lack a shared, machine-readable plan that multiple agents and worktrees can pick up and continue. This Skill converts a goal into a canonical multi-phase plan with dependencies, lanes, and acceptance criteria, then registers it on the local Loop daemon so any agent can resume the work. ## Core Features & Use Cases - Phased plan authoring: Decomposes a goal into phases with imperative titles, dependency edges, testable Done-when criteria, and descriptive suggested branches, following the canonical format in references/plan-format.md. - Parallelization analysis: Applies a three-part independence test (no dependency, low file contention, no coordination tax) to decide whether phases split into parallel lanes for separate Conductor worktrees, defaulting to a single sequential lane. - Daemon registration and optional Kestral linking: Writes .loop/plan.md, registers it via loop-plan.sh on the local daemon at http://localhost:7717, and optionally publishes a Kestral project, plan document, and parent task with phase subtasks. - Use Case: Ask to plan a full-stack feature; the Skill explores the codebase, drafts vertical-slice phases across repositories, registers the plan locally, and reports the planId so you can run /loop-pickup or /loop-execute in any worktree. ## Quick Start Ask the agent to plan out your next feature or refactor as a multi-phase plan, for example by saying plan out the migration of our billing service into phases.

Frequently Asked Questions about multiphase-plan

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

FAQPage Schema
How do I create a multi-phase implementation plan for a coding project?

Invoke the skill with your goal, and it explores the codebase, drafts phases with dependencies and Done-when criteria in the canonical plan format, then registers the plan on the local Loop daemon. You receive a planId to start work with loop-pickup.

How does the skill decide which phases can run in parallel worktrees?

Phases split into separate lanes only if they pass a three-part independence test: no dependency between them, low file contention, and no coordination tax such as stubs or feature flags. The default outcome is a single sequential lane.

Does the plan require Kestral to work?

No, Kestral linking is opt-in. Every plan is registered on the local Loop daemon at http://localhost:7717 as the base source of truth, and Kestral projects, documents, and tasks are created only when the user explicitly approves linking.

Can Codex agents use the same plan as Claude Code?

Yes, the durable contract is the daemon plan plus the .loop/plan.md file, not the chat session. A Codex agent in another worktree resumes from the same state using the planId and the $loop-pickup invocation style.

What happens if the Kestral MCP authentication fails?

If a Kestral call returns a 401 or unauthorized error, the skill tells you to reconnect through your host UI, such as /mcp reconnect in Claude Code or MCP server settings in Codex, and stops the linking flow.