handoff-files

Deterministic handoff-file skill and Claude companion implementation for OpenClaw orchestrator/executor workflows.

Why this repo exists

This repo is the implementation surface for the handoff-file workflow. It owns the actual writer / clearer scripts, the Claude-side handoff-respond skill, plugin manifests, and the byte-level handoff contract used on disk.

What this repo owns

This repo is the source of truth for:

• deterministic handoff file writing and cleanup
• managed handoff filenames
• on-disk header contract
• Claude-side handoff-respond implementation
• plugin packaging / manifests
• implementation tests

What this repo does not own

This repo does not own the full companion operations / validation layer. For those, see the companion repo:

• operations, validation, recovery, and examples: cryptolisboa-claw/claude-companion-skill

Repo relationship

The handoff system spans two repos by design:

1. Implementation: cryptolisboa-claw/handoff-files
2. Companion operations and validation: cryptolisboa-claw/claude-companion-skill

Boundary:

• handoff-files owns implementation and on-disk contract details
• claude-companion-skill owns companion contract docs, validation flow, install/verify/update/recovery guidance, and reusable examples

If these surfaces drift, treat references/contract.md in this repo as authoritative for byte-level handoff file behavior.

Start here

• skill contract: SKILL.md
• on-disk file contract: references/contract.md
• Claude-side skill: skills/handoff-respond/SKILL.md
• companion operations / validation docs: cryptolisboa-claw/claude-companion-skill