execute-plan

Execute structured development plans with phase progression and Git commits.

Updated May 24, 2025
One-click install
npx skills add https://github.com/rhys117/ai-setup --skill execute-plan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: execute-plan
Source: https://github.com/rhys117/ai-setup/tree/main/claude-setup/skills/execute-plan
Command: npx skills add https://github.com/rhys117/ai-setup --skill execute-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the execution of structured development plans created in the .llms/ directory. It guides phase progression, tracks progress, manages git commits, and handles validation cycles so you can move from plan to productive outcomes with minimal cognitive load.

Core Features & Use Cases

  • Phase-driven execution: Progress through each phase deterministically using dedicated subagents to ensure consistent results.
  • Progress tracking & commits: Updates plan status and commits changes at each phase boundary to maintain a clear history.
  • Validation & fix cycles: Detects failures during validation and orchestrates fix cycles with structured subplans when needed.
  • Plan continuity: Resume work on in-progress plans or pick up new ones created by create-plan.

Quick Start

Use the skill to run an active plan:

  • If there is exactly one active plan in .llms/, the skill will begin at the current phase.
  • If multiple active plans exist, you will be prompted to choose which plan to execute.
  • The skill will spawn phase-specific subagents (e.g., scope analysis, context gathering, solution design, etc.) to perform each phase and update the plan as it progresses.

Frequently Asked Questions about execute-plan

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

FAQPage Schema
How do I execute a structured development plan with automated phase progression?

Plan execution automates moving through each phase of a development plan stored in `.llms/`, delegating work to specialized subagents and tracking progress automatically. The Skill identifies your active plan, runs phase-specific tasks, updates status at each boundary, and commits changes to maintain an auditable trail.

Can I resume work on an in-progress development plan?

Yes, plan execution detects in-progress plans in `.llms/` and resumes from the current phase. If multiple active plans exist, you choose which to continue, then the Skill proceeds with phase-specific subagent delegation and progress tracking from that point forward.

What happens when plan validation fails during execution?

Plan execution detects validation failures and orchestrates fix cycles automatically. It creates structured subplans to address issues, reruns validation, and continues phase progression only after prerequisites are met, maintaining strict phase boundaries throughout.

How does git integration work with phase progression?

Plan execution commits changes at each phase boundary, creating a clear auditable history linked to phase completion. This ensures every phase transition is recorded and traceable, supporting both progress visibility and rollback capability if needed.

Do I need to manually manage subagent delegation across phases?

No, plan execution automatically spawns phase-specific subagents—scope analysis, context gathering, solution design, and others—based on your plan structure. Each subagent handles its phase's work and reports findings back to update the plan.

What format should my development plan use for execution?

Plans must be stored in `.llms/` directory and structured with distinct phases. Plan execution expects phase definitions, prerequisite markers, and status fields so it can track progress, delegate to subagents per phase, and manage validation cycles consistently.