How does the skill track progress?

It maintains a hidden JSON state block at the end of your PLAN markdown files, updating the status of each specific step from pending to in_progress, completed, or blocked in real-time.

In worker mode, the main Claude session acts as a coordinator. It identifies pending tasks and launches specialized sub-agents (plan-workers) to handle the implementation, which is ideal for complex project management.

Does it handle git commits automatically?

Yes, if the 'commit_after_phase' setting is enabled in the plan state, the skill will automatically stage modified files and create a descriptive commit after a phase is finished.

What is the difference between Plan Executor and Plan Generator?

Plan Generator is used to create the initial strategy and markdown structure, while Plan Executor is designed to take that existing plan and carry out the actual coding tasks, tracking progress as it goes.

Plan Executor

Name: Plan Executor
Author: bfreis

bybfreis

•

Productivity & Workflow

Coordinates and executes multi-phase project plans using persistent state tracking and sub-agent orchestration.

About

Plan Executor is a sophisticated workflow skill designed to operationalize markdown-based project plans. It bridges the gap between static planning and active implementation by maintaining a JSON state within your PLAN files, allowing Claude to track granular progress, handle complex dependencies, and manage specialized worker agents. Whether performing direct implementation or coordinating a fleet of sub-agents, this skill ensures structured progress, automated phase transitions, and reliable project continuity across multiple coding sessions.

Key Features

Persistent state tracking via JSON blocks embedded in markdown PLAN files
Integrated git commit management triggered upon phase completion
Automated phase advancement and real-time step status management
Robust error handling with specialized step-level blocking and unblocking logic
1 GitHub stars
Dual execution modes for either direct implementation or worker-based orchestration

Use Cases

Executing complex, multi-phase software development roadmaps with high precision
Coordinating sub-agents to complete independent project tasks in worker mode
Resuming long-term project work exactly where it left off after a session break

About

Key Features

Persistent state tracking via JSON blocks embedded in markdown PLAN files
Integrated git commit management triggered upon phase completion
Automated phase advancement and real-time step status management
Robust error handling with specialized step-level blocking and unblocking logic
1 GitHub stars
Dual execution modes for either direct implementation or worker-based orchestration

Use Cases

Executing complex, multi-phase software development roadmaps with high precision
Coordinating sub-agents to complete independent project tasks in worker mode
Resuming long-term project work exactly where it left off after a session break