Orchestrator-supaconductor executing-plans
Use when you have a written implementation plan to execute in a separate session with review checkpoints
git clone https://github.com/Ibrahim-3d/orchestrator-supaconductor
T=$(mktemp -d) && git clone --depth=1 https://github.com/Ibrahim-3d/orchestrator-supaconductor "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/executing-plans" ~/.claude/skills/ibrahim-3d-orchestrator-supaconductor-executing-plans && rm -rf "$T"
skills/executing-plans/SKILL.mdExecuting Plans
Overview
Load plan, review critically, execute all tasks autonomously to completion.
Core principle: Execution behavior depends on
conductor/config.json → "mode":
: Autonomous execution — never stop for human feedback. Resolve all issues by consulting lead agents or best-judgment."agentic"
: Stop at blockers and report to user. Wait for feedback between batches of 3 tasks."human-in-the-loop"
Announce at start: "I'm using the executing-plans skill to implement this plan."
The Process
Step 1: Load and Review Plan
- read_file plan file
- Review critically - identify any questions or concerns about the plan
- If concerns:
mode: Resolve autonomously — consult lead agents (Architecture Lead, Tech Lead) via subagent dispatch. NEVER ask the user."agentic"
mode: Raise concerns with the user before starting."human-in-the-loop"
- Create TodoWrite and proceed
Step 2: Execute Tasks (Mode-Dependent)
mode — Execute ALL tasks sequentially without stopping:"agentic"
For each task:
- Mark as in_progress
- Follow each step exactly (plan has bite-sized steps)
- Run verifications as specified
- If verification fails: attempt fix autonomously (max 3 retries per task), log the issue, continue to next task
- Mark as completed
mode — Execute in batches of 3 tasks, then pause:"human-in-the-loop"
For each batch (3 tasks at a time):
- Mark tasks as in_progress
- Follow each step exactly
- Run verifications as specified
- If verification fails: STOP and ask the user for help before continuing
- After each batch completes: report progress, say "Ready for feedback.", and wait before proceeding to next batch
Step 3: Report Progress
After tasks complete:
- Show what was implemented
- Show verification output
mode: Show any autonomous decisions made; do NOT wait for feedback — proceed to completion"agentic"
mode: Say "Ready for feedback." and wait"human-in-the-loop"
Step 5: Complete Development
After all tasks complete and verified:
- Announce: "I'm using the finishing-a-development-branch skill to complete this work."
- REQUIRED SUB-SKILL: Use orchestrator-supaconductor:finishing-a-development-branch
- Follow that skill to verify tests, present options, execute choice
Blocker Resolution (Mode-Dependent)
If mode =
: Resolve all blockers autonomously. NEVER stop.
If mode = "agentic"
: STOP and ask the user for help on any blocker."human-in-the-loop"
Agentic Mode Resolutions:
- Missing dependency → Install it if safe (<50KB), or skip the task and log the blocker
- Test fails → Attempt fix (max 3 retries), then log failure and continue with remaining tasks
- Instruction unclear → Spawn a Plan subagent to interpret based on codebase context, or consult Product Lead
- Plan has critical gaps → Consult Architecture Lead via subagent to fill gaps autonomously
- Verification fails repeatedly → Log the issue with details, mark task as
, continuecompleted-with-warnings
When to Revisit Earlier Steps
Return to Review (Step 1) when:
- Fundamental approach is failing (>50% of tasks failing) — re-plan autonomously
- Architecture Lead subagent recommends a different approach
Remember
- Review plan critically first
- Follow plan steps exactly
- Don't skip verifications
- Reference skills when plan says to
mode: Execute ALL tasks without stopping — resolve blockers autonomously, log all decisions"agentic"
mode: Execute in batches of 3 — stop at blockers and ask the user, wait for feedback between batches"human-in-the-loop"- Never start implementation on main/master branch — use feature branches
Conductor Integration (Autonomous Mode)
When invoked with
--plan, --track-dir, and --metadata parameters (from Conductor orchestrator):
- read_file plan from
path--plan
mode: Execute ALL tasks without stopping — run autonomously"agentic"
mode: Execute in batches of 3 — stop at blockers, wait for user feedback between batches"human-in-the-loop"- After each task: use replace tool to mark
in plan.md with commit SHA[x] - After all tasks: update
checkpoint to--metadataEXECUTE: PASSED - Return concise verdict:
{"verdict": "PASS", "tasks_completed": N} - If
is provided, skip tasks before that task ID--resume-from
When these parameters are absent, fall back to the standalone mode-aware workflow above.
Integration
Required workflow skills:
- orchestrator-supaconductor:using-git-worktrees - REQUIRED: Set up isolated workspace before starting
- orchestrator-supaconductor:writing-plans - Creates the plan this skill executes
- orchestrator-supaconductor:finishing-a-development-branch - Complete development after all tasks