Menu
Repairs a broken current harness, including task sync, hook routing, handoff, context-map, policy, helper, and generated/runtime drift.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
routes repo-harness requests through the CLI and hook automation plugin for init, update, scaffold, migrate, audit, repair, and ship workflows
Use when setting up or operating the repo-harness ChatGPT Controller, GitHub Issue Launcher, local Agent Runs, or GitHub Copilot cloud sessions.
Use when the user wants Codex to consult their logged-in ChatGPT Web session through repo-harness browser engine for planning, architecture review, PRD critique, or Codex goal generation.
Resolves repo-harness architecture drift requests and updates architecture docs or diagrams without running full init, migrate, or upgrade.
Full repo-harness workflow orchestrator. Reads repo state, drafts a plan, self-reviews twice, executes the approved plan, runs review/check gates, and delegates final PR closeout to repo-harness-ship.
Adds or syncs explicit repo-local capability boundaries without running full repo-harness init, migrate, or upgrade.
Based on SOC occupation classification
| name | repo-harness-repair |
| description | Repairs a broken current harness, including task sync, hook routing, handoff, context-map, policy, helper, and generated/runtime drift. |
| when_to_use | repo-harness-repair, repair broken agentic workflow, fix task sync, fix hook routing, fix handoff, repair .ai harness, repair context-map |
Use this command when the repo has a harness but a specific workflow surface is broken.
bun scripts/inspect-project-state.ts --repo <repo> --format text.settings.json -> .ai/hooks/run-hook.sh -> .ai/hooks/* or plans/ -> tasks/todos.md -> tasks/contracts/.repo-harness-init or repo-harness-migrate.repo-harness-check.repo-harness-migrate.