OpenParable
Skip to content
← Back to skills

Repo Harness Handoff

Productivity
repo-harness-handoff

Repo Harness Handoff is an Agent Skill for productivity published in the Ancienttwo/repo-harness repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/Ancienttwo/repo-harness/blob/HEAD/assets/skill-commands/repo-harness-handoff/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/repo-harness-handoff, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

repo-harness-handoff

Use this command when the user wants to save, refresh, or resume the repo-local handoff surface without running a full check or repair pass.

Protocol

  1. Confirm the target repo path and handoff reason.
  2. To prepare a rollover packet, run:
    • repo-harness run prepare-codex-handoff --reason <reason>
  3. Use --print-prompt when the user needs the exact fresh-session prompt.
  4. To resume from an existing packet, run:
    • repo-harness run codex-handoff-resume --cwd <repo> --reason <reason> --print-prompt
  5. Verify the handoff files exist and are current:
    • .ai/harness/handoff/current.md
    • .ai/harness/handoff/resume.md
  6. Report the exact next step from the handoff packet.

Failure Modes

  • If there is no active plan, the resume packet must report (none) for plan, contract, and notes.
  • If resume.md is older than current.md, regenerate with repo-harness run prepare-codex-handoff.
  • If the user asks for readiness, route to repo-harness-check instead of expanding this command.

Boundaries

  • Does not run /check.
  • Does not run repo-harness run check-task-workflow --strict unless the user asks for readiness verification.
  • Does not mutate plans, tasks, source code, or architecture docs except the handoff packet files.
  • Does not replace task sync, review, or release-readiness checks.