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
This commit is contained in:
Shay
parent
71fa729ddb
commit
c6e0b26e33
1 changed files with 43 additions and 30 deletions
|
|
@ -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:
|
||||
|
|
|
|||
Loading…
Reference in a new issue