orchestrate

Execute implementation plans with parallel TDD workers and hook-based quality gates.

Updated Sep 13, 2026
One-click install
npx skills add https://github.com/petemcw/farseer --skill orchestrate-petemcw
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: orchestrate
Source: https://github.com/petemcw/farseer/tree/main/skills/orchestrate
Command: npx skills add https://github.com/petemcw/farseer --skill orchestrate-petemcw

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Coordinating multi-task implementation plans by hand is slow and error-prone: dependencies must be tracked, tests must pass before commits, and interrupted runs must resume cleanly. This Skill automates that entire execution loop. ## Core Features & Use Cases - Parallel TDD execution: Builds a dependency graph from plan task files and spawns ready tasks as parallel tdd-worker subagents in batches. - Hook pipeline with drift detection: Runs pre-implementation, pre-batch, post-batch, post-implementation, pre-commit, and post-commit hooks discovered via a fingerprinted discovery script, halting on enrollment changes. - Safe commit gating: Commits nothing until the full test suite passes, with git-stash isolation to distinguish hook-agent breakage from worker breakage. - Resumable runs: All state lives in plan files on disk, so re-running after interruption resumes exactly where it stopped. - Use Case: After planning a user-authentication feature with the planner skill, run the orchestrator to implement all tasks autonomously, then get a push/PR prompt with linked GitHub issues. ## Quick Start Run the plan named user-auth by saying "run the user-auth plan" after creating it with the planner skill.

Frequently Asked Questions about orchestrate

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

FAQPage Schema
How do I run an implementation plan with parallel TDD workers?▼

Invoke the orchestrate skill with the plan name, for example "run the user-auth plan". It loads the plan's task files, builds a dependency graph, and spawns ready tasks as parallel tdd-worker subagents in batches until all tasks complete or block.

What happens if an orchestrated run is interrupted?▼

All run state lives in the plan files on disk, including task statuses, requirement checkboxes, and retry counts. Re-running the orchestrate command resumes exactly where the previous run stopped, treating in-progress tasks as pending.

Does the orchestrator commit code before tests pass?▼

No. Nothing is committed until the full test suite passes after post-implementation hooks. If tests fail, a git stash isolation step determines whether hook agents or TDD workers caused the breakage before committing or reporting TASKS_BLOCKED.

What are the prerequisites for running plan orchestration?▼

The plan must exist in the resolved plans directory with a _plan.md file, the project must have .farseer/testing.md configured, plan status must be ready or in_progress, and the current git branch must be feature/{plan-name}.

Why does orchestration halt with a hook fingerprint error?▼

The run captures a fingerprint of enrolled hook agents at start and passes it to every hook discovery call. If enrollment changes mid-run, the script exits with code 4 and halts execution so the pipeline matches what was reviewed.

When should I not use autonomous plan orchestration?▼

Avoid it when no structured plan exists yet, since it requires a plan created by the planner skill. It is also unsuitable when tasks need continuous human judgment, as execution is fully autonomous after invocation.