create-exec-plan

Creates validated YAML implementation plans under plans/active after repository investigation.

Updated Feb 6, 2026
One-click install
npx skills add https://github.com/maycuatroi1/agent-skills --skill create-exec-plan-maycuatroi1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-exec-plan
Source: https://github.com/maycuatroi1/agent-skills/tree/main/skills/create-exec-plan
Command: npx skills add https://github.com/maycuatroi1/agent-skills --skill create-exec-plan-maycuatroi1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a change request into an executable implementation plan usually means scattered chat notes, missed cross-repo dependencies, and invented verification commands. This Skill investigates the repository first, resolves blocking ambiguities with the user, and writes one complete, validated YAML plan artifact that another agent can execute without repeating discovery. ## Core Features & Use Cases - Investigation-first planning: Reads project docs, git history, contracts, and code before asking only decision-bearing questions, never asking for facts discoverable in the repo. - Canonical YAML plan artifact: Writes exactly one plans/active/<slug>.yaml file with goal, acceptance criteria, ordered repos and steps, seams, risks, rollback, and decisions, with no placeholders allowed. - Multi-repo merge ordering: Derives repository order from contract ownership so seam owners land before consumers, and validates the result with evo harness commands when available. - Use Case: A user asks to plan a feature spanning an API service and its client SDK. The Skill traces the contract seam, asks one round of clarifying questions about rollout and compatibility, then writes a validated plan with owner-before-consumer merge order and per-step verification commands. ## Quick Start Ask the agent to create an execution plan for your change, for example: create an execution plan for adding OAuth login across the auth service and web app.

Frequently Asked Questions about create-exec-plan

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

FAQPage Schema
How do I create an implementation plan for a multi-repo change?

Ask for an execution plan and the Skill traces impacted repositories and contracts, derives merge order from seam ownership, and writes one plans/active/<slug>.yaml file. Owners land before consumers, expressed in both order and depends_on fields.

What format does the execution plan use?

The plan is a single YAML file with English field names parseable by evo harness. It contains goal, acceptance criteria, repos, steps with verification commands, seams_touched, risks, rollback, decisions, and open_questions sections.

Does the skill implement the plan after writing it?

No. The plan is the only deliverable. The Skill explicitly stops after writing and validating the YAML file and never creates branches, edits product code, commits, or begins implementation.

When should I not use an execution plan workflow?

Skip it for short answers, brainstorming without a requested artifact, personal planning, or trivial edits where the implementation is clearer than a plan. It is designed for substantial work crossing repos, packages, or contract seams.

How does plan validation work with evo harness?

After writing, the Skill parses the YAML, checks required fields, unique step IDs, and acyclic dependencies, then runs evo harness show and graph commands when a harness root exists. It avoids evo harness check until planned branches actually exist.