Te templatehandoffmarkdowngovernancestable

HANDOFF.md

Cross-session continuity document written at a context boundary: current state, next steps, open questions, files in flight, last known-good commit, audit references. The resuming session verifies every gating assertion against live state before acting on it.

id template/handoffv1.0.0placeholders 9

Skeleton

# HANDOFF — {{task}}

Last updated: {{updated}} · Branch: {{branch}}

## Current state

{{current_state}}

## Next steps

{{next_steps}}

## Open questions

{{open_questions}}

## Files in flight

{{files_in_flight}}

## Last known-good commit

{{last_good_commit}}

## Audit references

{{audit_refs}}

Rendered example

# HANDOFF — template class for ai-atoms

Last updated: 2026-09-03T20:10:00Z · Branch: feat/template-class

## Current state

Schema and eight template atoms written and validating. Site pages not started. Nothing committed on this branch yet.

## Next steps

1. Add listing and detail pages under web/src/pages/atoms/template/.
2. Run `python3 scripts/build-exports.py` and `python3 -m pytest`.
3. Commit in two pieces: schema+atoms, then site.

## Open questions

None.

## Files in flight

schemas/template-v1.json, atoms/template/*.json, web/src/lib/catalog.ts

## Last known-good commit

0b0be7d Second curation pass: descriptions, Cloudflare models, vendors, workflow removal (#53)

## Audit references

none

Placeholders

Name	Required	What goes here	Example
`{{task}}`	yes	What the work is, in a few words.	template class for ai-atoms
`{{updated}}`	yes	ISO-8601 timestamp.	2026-09-03T20:10:00Z
`{{branch}}`	yes	Branch the work is on.	feat/template-class
`{{current_state}}`	yes	What is in flight and what is committed. Facts a resuming session can verify.	Schema written; eight atoms written; site pages not yet.
`{{next_steps}}`	yes	Concrete actions for the resuming session, in order.	1. Add site pages. 2. Run the build.
`{{open_questions}}`	yes	Decisions awaiting input, each with who can answer it.	None.
`{{files_in_flight}}`	yes	Paths being modified, with line ranges when helpful.	web/src/lib/catalog.ts, schemas/template-v1.json
`{{last_good_commit}}`	yes	SHA plus one line.	0b0be7d Second curation pass
`{{audit_refs}}`	no	In-progress override or violation log entries, or 'none'.	none

Rules for the finished document

No secrets in any section; write [REDACTED:<kind>] where one would otherwise appear.
On resume, verify every assertion that gates an action against live state before running it.
Write or update it whenever continuity is at risk, not only at the end.

Produced by

skill/checkpoint — Session Checkpoint

handoffcheckpointcontinuityrequired-document

Author convergent-systems-key. Source ai-atoms. License CC-BY-4.0. Section set from the AI Constitution's handoff rule (§3.38); migrated from prompt/handoff-md, whose prose described this shape.