master-plan

Decompose large initiatives into coordinated ExecPlans with dependencies and integration points.

5|1|Updated May 4, 2026
One-click install
npx skills add https://github.com/shinzui/keiro --skill master-plan-shinzui
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: master-plan
Source: https://github.com/shinzui/keiro/tree/main/agents/skills/master-plan
Command: npx skills add https://github.com/shinzui/keiro --skill master-plan-shinzui

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Large initiatives that span multiple work streams are hard to coordinate: single plans become unwieldy, dependencies between work streams get lost, and parallel contributors make conflicting assumptions about shared interfaces. This Skill manages MasterPlans — living coordination documents that decompose an initiative into independently implementable child ExecPlans with explicit dependency modeling. ## Core Features & Use Cases - Initiative Decomposition: Breaks large efforts into two to seven child ExecPlans grouped by functional concern, with hard, soft, and integration dependencies modeled explicitly. - Six Operating Modes: create, implement, status, update, discuss, and review — covering the full lifecycle from planning through execution to retrospective. - Provenance & ADR Integration: Records which model authored, revised, or reviewed each plan via append-only frontmatter entries, and promotes durable cross-plan decisions into Architecture Decision Records. - Use Case: You need to add a Kafka consumer pipeline spanning a data model, consumer logic, and an API endpoint. Run create mode to generate a MasterPlan in docs/masterplans/ plus self-contained child ExecPlans in docs/plans/, then implement them in dependency order with git trailers tracking every commit. ## Quick Start Ask the agent to create a master plan for your initiative, for example: create a master plan for adding a Kafka consumer pipeline with separate plans for the data model, consumer, and API endpoint.

Frequently Asked Questions about master-plan

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

FAQPage Schema
How do I break a large software initiative into multiple implementation plans?

Use the master-plan skill's create mode, which researches the codebase, identifies work streams by functional concern, and generates a MasterPlan plus two to seven child ExecPlans. Each child plan is self-contained and independently implementable once its hard dependencies complete.

When should I use a MasterPlan instead of a single ExecPlan?

Use a MasterPlan when work spans three or more distinct functional concerns, has ordering constraints, or would exceed five milestones in one plan. If the work fits in a single ExecPlan with two to four milestones, use an ExecPlan directly.

What is the difference between hard, soft, and integration dependencies?

Hard dependencies block a child plan until another completes because required artifacts would not exist. Soft dependencies allow progress with temporary stubs. Integration dependencies mean two plans define shared interfaces that must be reconciled.

How does the skill track which AI model wrote or reviewed a plan?

Each plan's YAML frontmatter carries an optional provenance block with created_by, revisions, and reviews lists. Entries are appended only by the record-provenance.ts script, never hand-edited, so multiple models' reviews accumulate without overwriting.

Can a MasterPlan be changed after child plans are already in progress?

Yes, update mode supports adding, cancelling, splitting, merging, or reordering child plans. Changes cascade to affected child plans, are recorded in the Decision Log, and durable cross-plan decisions are promoted into ADRs.