8Dionysus/aoa-checkpoint-closeout-bridge

aoa-checkpoint-closeout-bridge

Intent

Use this skill to connect checkpoint-led session growth with explicit reviewed closeout execution.

It does not replace the core session-growth skills. It keeps checkpoint capture provisional during the session and then drives the explicit reviewed-closeout chain in the fixed order:

aoa-session-donor-harvest -> aoa-session-progression-lift -> aoa-quest-harvest

Trigger boundary

Use this skill when:

• checkpoint notes already carry harvest, progression, or upgrade candidates
• reviewed closeout must use those candidates as focus hints without treating them as final authority
• the route needs one explicit bridge from local checkpoint evidence into the reviewed session-harvest family
• the honest next move is not raw recap, but a bounded session-end chain

Do not use this skill when:

• the session is still active and only mid-session collection is needed
• there is no reviewed artifact yet
• the task is to implement or patch the bridge itself rather than execute a reviewed closeout chain
• the task wants final harvest, progression, or quest verdicts from checkpoint notes alone
• the request tries to make aoa closeout run a hidden skill runner

Inputs

• reviewed session artifact
• optional local checkpoint note
• optional reviewed surface closeout handoff
• optional receipt refs from already published or staged session evidence
• repo scope and touched owner hints
• full session evidence available to the agent, such as the reviewed artifact, Codex rollout trace, transcript excerpts, and relevant receipts

Outputs

• in checkpoint-collect mode:
  • updated local checkpoint note
  • updated provisional progression-axis hints
  • ordered session-end target list
• in reviewed-closeout-execute mode:
  • one explicit execution context bundle
  • one explicit run of:
    • aoa-session-donor-harvest
    • aoa-session-progression-lift
    • aoa-quest-harvest
  • one execution report that records what ran, what was skipped, and which artifacts or receipts were emitted
  • one agent-authored closeout summary that says which conclusions came from reread session evidence, which checkpoint hints were accepted, and which hints were rejected as stale, cross-session, or contaminated

Procedure

1. during checkpoint collection, keep the note append-only and provisional
2. treat checkpoint candidates and progression-axis hints as shortlist inputs, not verdict authority
3. publish the reviewed-closeout target order explicitly:
   • donor harvest first
   • progression lift second
   • quest harvest third
4. before executing reviewed closeout, the Codex agent must reread the skill instructions and the primary session evidence; checkpoint JSON, generated packets, and closeout reports are only navigation aids
5. when executing reviewed closeout, reread the full reviewed artifact before every core skill stage
6. let checkpoint note and reviewed handoff narrow attention, but never replace the reviewed artifact or receipt evidence
7. explicitly separate current-session evidence from stale, neighboring, or diagnostic checkpoint contamination before naming final candidates
8. run aoa-session-donor-harvest first so reusable units and owner routing are bounded before any progression verdict
9. run aoa-session-progression-lift second so final multi-axis movement is gathered from reviewed evidence, donor outputs, and provisional checkpoint axes together
10. run aoa-quest-harvest third so final promotion triage happens only after donor harvest and progression lift have finished
11. keep stats refresh out of this bridge skill; that remains downstream after explicit closeout receipts exist

Contracts

• checkpoint note stays provisional and lower-authority than reviewed closeout
• checkpoint-collect never emits final harvest, progression, or quest verdicts
• reviewed-closeout-execute must reread the reviewed artifact and any receipt evidence; it may not trust checkpoint notes alone
• generated bridge artifacts are mechanical outputs, not proof that the agent applied the skill protocol; the agent must still produce the final analytical judgment from reread evidence
• core skill order is fixed:
  • aoa-session-donor-harvest
  • aoa-session-progression-lift
  • aoa-quest-harvest
• this bridge skill coordinates core skills; it does not replace their meaning
• aoa closeout run remains a separate receipt-first publisher path
• stats refresh is not part of this skill

Risks and anti-patterns

• treating checkpoint hints as if they were final donor harvest truth
• treating execute-closeout-chain JSON as if it were the actual skill application instead of an artifact bundle that still needs agent judgment
• skipping donor harvest and jumping straight to progression or quest verdicts
• using progression verdicts that were not reread against the reviewed artifact
• letting quest harvest run before progression lift
• turning the bridge into a hidden auto-runner inside aoa closeout run
• refreshing stats before the explicit reviewed-closeout chain finishes

Verification

• confirm checkpoint-collect only updates local ledger surfaces
• confirm the bridge never emits final verdicts during mid-session capture
• confirm reviewed closeout refuses to run without a reviewed artifact
• confirm the core skill order is fixed and visible
• confirm checkpoint note and reviewed handoff are treated as hints rather than sole evidence
• confirm the final answer distinguishes current-session evidence from checkpoint hints and from stale or contaminated ledger entries
• confirm the execution report's mechanical bridge outputs were not presented as autonomous skill analysis
• confirm stats refresh remains downstream of the bridge execution

Technique traceability

Manifest-backed techniques:

• AOA-T-0075 from 8Dionysus/aoa-techniques at 5c6f0496edc3c2e74590baa35627c85fe58ef765 using path techniques/agent-workflows/session-donor-harvest/TECHNIQUE.md and sections: Intent, Inputs, Outputs, Contracts, Validation
• AOA-T-0084 from 8Dionysus/aoa-techniques at 5c6f0496edc3c2e74590baa35627c85fe58ef765 using path techniques/agent-workflows/progression-evidence-lift/TECHNIQUE.md and sections: Intent, Inputs, Outputs, Contracts, Validation
• AOA-T-0089 from 8Dionysus/aoa-techniques at 5c6f0496edc3c2e74590baa35627c85fe58ef765 using path techniques/agent-workflows/quest-unit-promotion-review/TECHNIQUE.md and sections: Intent, When to use, Inputs, Outputs, Core procedure, Contracts, Validation

Adaptation points

Project overlays may add:

• local reviewed artifact entrypoints
• local receipt bundle locations
• local stop conditions before quest triage
• local owner-layer route maps for generated donor packets
• project-local reviewed follow-through notes under docs/session-harvests/ when bridge upkeep becomes reusable but is still below promotion authority
• project-local reminders that downstream aoa-session-self-diagnose, owner follow-through, and stats refresh stay explicit next steps outside this skill
• local post-closeout stats or owner follow-through commands that stay outside this bridge skill