repo-harness

routes repo-harness requests through the CLI and hook automation plugin for init, update, scaffold, migrate, audit, repair, and ship workflows

Resolves repo-harness architecture drift requests and updates architecture docs or diagrams without running full init, migrate, or upgrade.

Adds or syncs explicit repo-local capability boundaries without running full repo-harness init, migrate, or upgrade.

Verification entrypoint for repo-harness workflow readiness. Runs workflow gates, task sync, contract checks, inspector, and migration dry-run before merge or release.

Installs or refreshes the repo-harness workflow in an existing repository. Adds hooks, docs/spec.md, tasks, plans, .ai/context, .ai/harness, helpers, and policy without creating an application stack.

Migrates older Claude/Codex workflow repos to the current tasks-first harness while preserving or archiving user-authored docs and hooks.

Generates an AI-implementation-friendly PRD from a product idea into plans/prds/, with tiered sections, evidence rules, and sprint-consumable structure.

Interactive planning entrypoint for repo-local agentic development work. Produces an approved plan before implementation and routes to init, scaffold, migrate, upgrade, repair, or check only after the decision is clear.

Reviews an existing repo-harness plan across product, engineering, design, and DevEx dimensions before implementation or release follow-through.

Program-level sprint planning and execution entrypoint. Uses upper-layer PRDs from plans/prds/ when present, writes ordered sprint backlogs in plans/sprints/, expands contract rows with $think into plan/contract/worktree flow, and keeps inline rows inside the sprint backlog or active plan checklist.

Checks deploy and private operations configuration for an repo-harness harness without publishing or deploying.

Goal-mode entrypoint for Codex and Claude native /goal sessions. Requires detailed PRD or Sprint context before starting bounded long-running execution.

Prepares or resumes Codex handoff packets for long-task rollover without running the full workflow check surface.

Final repo-harness closeout workflow. Runs review/check gates, commits finished contract worktrees, pushes codex branches, and creates GitHub PRs by default.

Direct GPT Pro consult facade for repo-harness. Use when the user asks for repo-harness:gptpro, GPT Pro advice, GPT Pro review, gptpro consult, or continuing/opening a GPT Pro browser session through the Oracle-first local ChatGPT Web browser provider.

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.

Guides GPT Pro local setup for repo-harness by configuring Oracle-first gptpro_browser ChatGPT Web consults and gptpro_mcp ChatGPT Connector MCP sidecar access with verification, auth, tunnel, runtime, and API-billing boundaries.

Use when setting up or operating the repo-harness ChatGPT MCP Connector, bridging ChatGPT planning artifacts into Codex execution through repo-harness PRDs, sprints, checks, and handoffs.

Get an independent cross-model code review from Anthropic Claude (a different vendor's model) on the current review scope: branch diff plus staged, unstaged, and untracked working tree changes, from inside a non-Claude host such as Codex. A different training distribution has non-overlapping blind spots, so Claude catches spec ambiguity, missing edge cases, and fake tests that Codex's self-review cannot see. Use before merging, after a tricky change, or for a debug second opinion. Triggers: "claude review", "second opinion", "ask claude", "outside voice", "让 claude 审", "找外部意见", "二审".

Get an independent cross-model code review from OpenAI Codex (a different vendor's model) on the current review scope: branch diff plus staged, unstaged, and untracked working tree changes. A different training distribution has non-overlapping blind spots, so Codex catches spec ambiguity, missing edge cases, and fake tests that Claude's self-review cannot see. Use before merging, after a tricky change, or for a debug second opinion. Triggers: 'codex review', 'second opinion', 'cross review', 'outside voice', '让 codex 审', '找外部意见', '二审'.

Repairs a broken current harness, including task sync, hook routing, handoff, context-map, policy, helper, and generated/runtime drift.

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.

Branch command that creates a new project or module scaffold from the repo-harness plan catalog A-K, then attaches the repo-local workflow harness.

Refreshes an already-installed repo-harness harness using manifest-owned upgrade actions from assets/workflow-contract.v1.json.