plan-coordinator

Parse markdown implementation plans and generate execution maps with agent assignments.

Updated Oct 15, 2025
One-click install
npx skills add https://github.com/odeciojunior/claude-play --skill plan-coordinator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-coordinator
Source: https://github.com/odeciojunior/claude-play/tree/main/plugins/productivity-tools/skills/plan-coordinator
Command: npx skills add https://github.com/odeciojunior/claude-play --skill plan-coordinator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Projects often store implementation plans as scattered markdown files without an actionable, assignable execution plan. This Skill reads those plans, extracts and normalizes every step, assigns specialized executor agents, identifies parallel groups and bundles, and writes a persistent progress file so teams can approve and delegate work reliably.

Core Features & Use Cases

  • Execution Map Generation: Parse plan steps (number, title, description, dependencies, inputs, outputs, validation, effort) and produce a group-oriented map that assigns agents and marks parallelism or bundles.
  • Agent Discovery & Assignment: Read .claude/agents/*.md metadata to match steps to the most suitable executor, with sensible fallbacks to general-executor.
  • Dependency Resolution & Bundling: Resolve inputs and prior outputs, flag skipped or completed steps, and apply bundling rules to balance context budget and retry boundaries.
  • Progress File Persistence: Write a full progress-<plan-name>.md containing the Execution Map, recovery state, wave logs, and per-step context blocks for main-context delegation.
  • Use Case: Turn a project's docs/plans/<topic>/*-plan.md into an approved, delegation-ready Execution Map that the main context can use to launch executor agent waves.

Quick Start

Parse the plan in docs/plans/<topic> and generate a complete Execution Map with agent assignments and a progress-<plan-name>.md ready for user approval.

Frequently Asked Questions about plan-coordinator

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

FAQPage Schema
How do I turn markdown implementation plans into assignable execution maps?

To generate an execution map from markdown plans, this Skill parses steps, dependencies, and inputs from plan files, then assigns executor agents and prepares a structured progress file for user approval. It matches step requirements to specialized agent metadata for delegation.

What is dependency resolution and task bundling in execution planning?

Dependency resolution in execution planning resolves step inputs against prior outputs, flags completed or skipped steps, and applies bundling rules to balance context budget and retry boundaries. This structures parallel execution groups for reliable agent delegation.

How do I assign executor agents to multi-step project plans?

To assign executor agents to multi-step plans, this Skill reads agent metadata files to match steps to the most suitable specialized executor. It applies sensible fallbacks to a general-executor for delegation when specific matches are unavailable.

Does this execution planning approach work with existing markdown plan files?

Yes, this execution planning approach works directly with existing markdown plan files under the docs/plans directory. It parses the number, title, description, dependencies, inputs, outputs, validation, and effort fields defined within those files.

How do I track progress and recovery state for delegated plan execution?

To track progress and recovery state for delegated plan execution, this Skill writes a persistent progress file containing the execution map, recovery state, wave logs, and per-step context blocks. This file enables reliable main-context delegation and approval workflows.