worktrail

Worktrail is a task orchestration system designed to be spec-format-agnostic, enabling parallel execution across git worktrees, deterministic route classification, and work-queue handoff. It was extracted from the `developer-kit` Claude Code plugin marketplace to be consumed by any harness with any task format via the `TaskSource` adapter interface. The system understands multiple task formats including DevKit task files, OpenSpec changes, and GitHub Spec Kit feature tasks. It includes a once-per-session Stop hook that captures exceptional next-step ideas after substantive work. Key autonomous operation features: - `worktrail-drain` runs the work queue unattended, spawning headless one-shot executions (Claude, Codex, or OpenCode) that claim queued briefs, perform work, and open PRs. - Intake triage pre-pass: Evaluates intake briefs against active changes, proposes verdicts (e.g., fold-into-change, propose-change), and applies approved actions (default off). - Backlog seeding: Converts planning backlog (e.g., specs in `needs-tasks` stage) into queue briefs (default on), with deterministic and deduplicated seeding. - Human decision queue: When a product decision is required, files a structured record and waits for human input via `worktrail-decision` commands or file edits. - Operator configuration: Uses `~/.worktrail/routing.yaml` for target and tier definitions, which govern provider/model selection during drain operations. - Resumable state handling: Sweeps for and recovers from interrupted states (e.g., budget-exhausted, verify-pending). The system also provides `worktrail-check-provider-commands` to validate generated commands against CLI parsers without authentication.