meta-handover

1. Purpose

Cross-session continuity. Captures repo state + done/undone bullets + critical context + recommended next actions into one markdown file the next agent reads cold. Used when handing to Claude Coworker, a different CC session, or a teammate.

Why this slot: today /handover is a command; agents can't dispatch it. This agent makes handover a first-class subagent so the publishing orchestrator (or any pillar's flow) can call Agent(subagent_type: "meta-handover") at flow end.

2. Triggers

Verbal cues (auto-invoke):

• "handover" / "/handover" / "switching agents" / "next session pick up"
• "I'm done for now" (if mid-task — distinguish from /eod)
• "draft a handover for X"

Conditional triggers:

• Session about to end with uncommitted work + at least one open task
• Switching from FrankX → another repo with active state
• Publishing-orchestrator or research-orchestrator flow completes with partial-success

Manual dispatch:

• Agent(subagent_type: "meta-handover", prompt: "handover for next agent picking up the L99 wrapper sprint")
• @meta-handover inline

NOT triggered by: end-of-day wrap-up where Frank resumes tomorrow (that's /eod / @meta-eod).

3. Inputs

Read-only:

• git log --oneline -10 --decorate
• git status --short --branch
• git diff --stat origin/main...HEAD
• docs/sessions/UNFINISHED-*.md, docs/sessions/NEXT-SESSION-*.md (if any)
• ~/.claude/projects/*/memory/MEMORY.md (relevant memory entries by keyword)

Optional:

• Current TaskList state — to surface in-flight + blocked items

Write-only:

• docs/ops/HANDOVER-<YYYY-MM-DD>.md

Must not modify: never edits agents.ts, never touches src/. Pure capture.

4. Process

0. Recall prior context (memory layer):
   node lib/acos/memory.mjs recall "meta-handover session: <project>" 3
   If prior handover for same project exists, reference it (avoid duplicate context).

1. Gather state in parallel:
   - git log --oneline -10 --decorate
   - git status --short --branch
   - git diff --stat origin/main...HEAD 2>/dev/null || echo "no remote"
   Capture all three.

2. Check for unfinished session docs:
   ls docs/sessions/UNFINISHED-*.md docs/sessions/NEXT-SESSION-*.md 2>/dev/null
   If found, READ their content (don't just reference — the next agent may not look there).

3. Detect project from cwd:
   - /c/Users/frank/FrankX → "FrankX"
   - /c/Users/frank/gencreator.ai → "GenCreator"
   - else basename of pwd

4. Compose HANDOVER-<date>.md per the /handover command template:
   - ## Situation (one paragraph)
   - ## What's Done (specific bullets — file paths, route names)
   - ## What's Not Done (each with WHY — blocked/deferred/ran-out)
   - ## Critical Context (non-obvious decisions, env vars, broken files)
   - ## Recommended Next Actions (1–3, ordered)
   - ## Files to Read First (annotated with why)
   - ## Repo Map (if multi-repo)

5. Atomic write to docs/ops/HANDOVER-<YYYY-MM-DD>.md.
   If file exists (multiple handovers same day), suffix with -<HHmm>.

6. Persist to memory:
   node lib/acos/memory.mjs remember '{
     "agent":"meta-handover",
     "intent":"meta-handover session: <project>",
     "approach":"handover written to <path>, N done bullets, M not-done",
     "score":0.9,
     "tags":["handover","continuity","<project>"],
     "metadata":{"path":"<file>","done_count":<N>,"undone_count":<M>}
   }'

7. Print path + summary lines. Do NOT commit (caller decides commit timing).