From c6e0b26e33d4a3036840b179f1e51edd41931280 Mon Sep 17 00:00:00 2001
From: Shay <assetoverflow@icloud.com>
Date: Wed, 17 Jun 2026 06:52:44 -0700
Subject: [PATCH] upgrade docs/handoff_template.md to mastery level for Grok
 Build: add Versor Coherence Guardian checks, subagent reconciliation section,
 skills usage tracking, and stronger invariant verification language

---
 docs/handoff_template.md | 73 +++++++++++++++++++++++-----------------
 1 file changed, 43 insertions(+), 30 deletions(-)

diff --git a/docs/handoff_template.md b/docs/handoff_template.md
index 97158354..c0bef437 100644
--- a/docs/handoff_template.md
+++ b/docs/handoff_template.md
@@ -1,22 +1,24 @@
 # HANDOFF — [AGENT] — [YYYY-MM-DD]
 
 <!-- Copy this file, rename to HANDOFF-[agent]-YYYY-MM-DD.md, fill in all
-     sections.  Do not leave placeholders.  This doc is the ONLY continuity
-     mechanism for stateless agents (Grok 4.3, GPT-5.5) across sessions. -->
+     sections completely. This is the ONLY continuity mechanism for stateless
+     agents (Grok 4.3 / Grok Build) across sessions. Do not leave placeholders. -->
 
 ## Agent and Session
 
 - **Agent:** <!-- grok43 | gpt55 | claude | other -->
 - **Date:** <!-- YYYY-MM-DD -->
-- **Reasoning effort used:** <!-- high | medium | low -->
-- **Session entry point:** <!-- What task was handed to this agent? -->
+- **Reasoning effort used:** <!-- high (mandatory for algebra/field) | medium | low -->
+- **Grok Build mode used:** <!-- TUI | Plan Mode | Arena (parallel subagents) | Headless -->
+- **Session entry point:** <!-- Exact task handed to this agent -->
 
 ---
 
-## Smoke Suite Status
+## Smoke Suite + Bootstrap Status
 
 ```
 <!-- Paste output of: core test --suite smoke -q -->
+<!-- Confirm core-bootstrap skill completed successfully -->
 ```
 
 ---
@@ -31,17 +33,29 @@
 
 ---
 
-## Invariants Verified
+## Invariants Verified (Versor Coherence Guardian + Core)
 
-<!-- For each invariant relevant to this session, state how it was confirmed. -->
+<!-- For each relevant invariant, state how it was confirmed. Include Versor Coherence Guardian checks. -->
 
-| Invariant | Check performed | Result |
-|---|---|---|
-| versor_condition < 1e-6 | | |
-| Normalization boundary | | |
-| No approximate recall | | |
-| INV-21 (VaultStore callers) | | |
-| Other (name it) | | |
+| Invariant | Check performed | Result | Notes |
+|---|---|---|---|
+| `||F * reverse(F) - 1||_F < 1e-6` (core closure) | Versor Coherence Guardian + tests/test_versor_closure.py | | |
+| versor_apply / cga_inner exactness | Manual trace + re-run of affected paths | | |
+| Normalization boundaries respected | Pre-edit sweep + code review | | |
+| No approximate recall (ANN/HNSW/cosine) | Full import/call-site sweep | | |
+| Claim status transitions via review gates only | Claim-proposal-guardian checks | | |
+| Safety/identity pack immutability | Safety-pack-auditor | | |
+| INV-21 / INV-24 / INV-29 (Vault & epistemic) | Explicit verification | | |
+| Other (name it) | | | |
+
+---
+
+## Subagent / Arena Reconciliation (if applicable)
+
+<!-- If Arena/parallel subagents were used -->
+- Number of subagents spawned: 
+- Each subagent independently verified versor closure? (Yes/No)
+- How were results reconciled before merge?
 
 ---
 
@@ -55,10 +69,7 @@
 
 ## Open Tasks / Next Session Entry Point
 
-<!--
-  Be specific.  "Continue the work" is not acceptable.
-  Name the exact module, function, or ADR phase the next session should start on.
--->
+<!-- Be extremely specific. "Continue the work" is not acceptable. -->
 
 1.
 2.
@@ -68,25 +79,27 @@
 
 ## Known Hazards / Do Not Touch
 
-<!--
-  Anything that is mid-refactor, has a known fragile state, or must not be
-  edited until a specific prior step is complete.
--->
+<!-- Mid-refactor state, fragile areas, or steps that must complete first. -->
 
 ---
 
 ## Architectural Decisions Made This Session
 
-<!--
-  Any decision that affects more than this session's diff — operator choices,
-  boundary calls, ADR interpretations.  Future sessions need this context.
--->
+<!-- Any decision affecting future sessions (operator choices, boundary calls, ADR interpretations). -->
 
 ---
 
 ## What Must Not Be Forgotten
 
-<!--
-  The single most important thing the next session agent must know.
-  Write it as if this doc is the only thing they will read.
--->
+<!-- The single most important thing the next agent must know. Write it as if this is the only document they will read. -->
+
+---
+
+## Skills Used This Session
+
+<!-- List which Grok Build skills were invoked (manual or auto-triggered) -->
+- core-bootstrap: 
+- versor-coherence-guardian: 
+- pre-edit-sweep: 
+- claim-proposal-guardian: 
+- Other: