superforge-handoff

Superforge Handoff — Cross-Model Session Transition Protocol

Use this skill whenever switching AI models, before clearing long chat threads, or when ending a work session. It writes a structured handoff capsule to .handoff/ so any AI model can instantly resume work.

1. Triggering Handoff (/handoff or /superforge-handoff)

1. Ensure directory .handoff/ exists.
2. Create capsule file: .handoff/YYYY-MM-DD-<slug>.md.
3. Populate the Resume Capsule (under 80 lines):
   • Project & Passphrase (<repo>: <catchy phrase>)
   • Objective & Verified State
   • Running Processes & Active Ports
   • The docs/ ledger — see below. This is the part that carries the decisions; without it the capsule carries the conversation instead
   • Immediate Next Steps
   • Files to Read First

The docs/ ledger — do not skip this

List every file in docs/, not a summary of them. One row each, read from the file's own header block:

## docs/
| File | Status | Last updated | Open questions |
|---|---|---|---|
| superforge.md | agreed | 2026-07-29 | — （会話=日本語 / ファイル=英語） |
| product-idea.md | agreed | 2026-07-30 | none |
| business-model.md | draft | 2026-07-31 | pricing tier 3 undecided |
| design.md + design.html | agreed | 2026-07-31 | — |
| accessibility.md | draft | 2026-07-29 | 3 criteria not assessed |
| verification.md | — | — | **not run yet** |
| security.md | FINDINGS-OPEN | 2026-07-31 | 1 High 未対応 |
| ship-readiness.md | — | — | **not run yet** |
| failforward.md | 6 entries | 2026-07-31 | 1 mitigation, cause still unknown |

Five rules that make this worth writing:

• superforge.md goes first, and its language settings travel with it. A resumed session that starts replying in the wrong language has lost something the user set explicitly, and will be corrected manually every time.
• A file that does not exist gets a row saying so. "verification.md — not run yet" is the single most useful line in the capsule, because it tells the next session what has not been proven. A missing row reads as "handled."
• Copy the Status and Last updated from each file's own header, not from memory. A capsule that claims agreed for something still marked draft is worse than no capsule.
• Carry every ## Open questions section forward. Those are exactly the decisions an unattended run is allowed to make with a logged default — losing them means the next session either re-asks or re-decides silently.
• failforward.md is the one row that is a count, not a status. Note the number of entries and, specifically, any mitigation shipped without a root cause — an open failure the next session would otherwise rediscover the hard way.