core/docs/handoff_template.md
Shay e36591ed46
docs(agent-governance): add Grok 4.3 / Grok Build engineering harness (#798)
* feat: add Grok 4.3 agent config, GROK.md, GPT55.md, handoff template, and .env additions

- GROK.md: full agent instructions optimized for Grok 4.3 high-effort mode
- GPT55.md: agent instructions for GPT-5.5 (o3-level reasoning, stateless)
- docs/handoff_template.md: mandatory cross-session handoff artifact template
- .env.grok43: Grok 4.3 environment config additions (do not commit secrets)
- AGENTS.md: prepend Grok 4.3 multi-agent/Arena mode addendum block

* feat: prepend Grok 4.3 / GPT-5.5 multi-agent addendum to AGENTS.md

* refine GROK.md: add Versor Coherence Guardian Protocol section + tighten NON-NEGOTIABLE INVARIANTS with explicit versor_apply / cga_inner / FieldState / claim schema / safety pack rules for stronger algebraic and epistemic guardrails

* refine AGENTS.md: align Grok 4.3 / Grok Build hard stops with refined GROK.md (Plan Mode, skills system, Versor Coherence Guardian references) while preserving full compatibility for Claude

* 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

* expand .env.grok43 into full Grok Build mastery configuration (skills dir, Plan Mode preference, Arena settings, auto-invoke)

* create skills/core-bootstrap.md - highest priority Grok Build skill for statelessness compensation

* create skills/versor-coherence-guardian.md - critical Grok Build skill enforcing the new Versor Coherence Guardian Protocol

* create skills/pre-edit-sweep.md - Grok Build skill implementing the Pre-Edit Sweep Protocol at mastery level

* create skills/claim-proposal-guardian.md - Grok Build skill protecting claim schema and epistemic rigor

* create docs/core-rd-base-prompts.md - high-signal, architecture-grounded prompt library for HITL and agentic use (lightly polished for structure and scannability)

* add Phase-Specific Prompt Library reference section to GROK.md pointing to the new docs/core-rd-base-prompts.md

* add reference to docs/core-rd-base-prompts.md in AGENTS.md Grok section

* add prompt library reference to handoff_template.md in the 'What Must Not Be Forgotten' section

* move .env.grok43 to docs/examples/grok43.env.example as a proper example file

* remove old .env.grok43 (moved to docs/examples/grok43.env.example)

* update docs/core-rd-base-prompts.md: fix epistemic wording + add sections #8 PR Merge-Readiness Audit and #9 Grok Build Implementation Session

* make 'full suite before merge' rule scope-sensitive in GROK.md for docs/config-only changes

* add reference to new prompt sections #8 and #9 in handoff_template.md

* create docs/grokbuild/README.md - comprehensive SpaceX-level mastery guide for using Grok 4.3 + Grok Build on CORE

* fix broken markdown fences in sections #8 and #9 of docs/core-rd-base-prompts.md

* fix skill invocation wording and soften curl|bash recommendation in docs/grokbuild/README.md

* docs(agent-governance): clean handoff template whitespace
2026-06-17 07:27:50 -07:00

107 lines
3 KiB
Markdown

# HANDOFF — [AGENT] — [YYYY-MM-DD]
<!-- Copy this file, rename to HANDOFF-[agent]-YYYY-MM-DD.md, fill in all
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 (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 + Bootstrap Status
```
<!-- Paste output of: core test --suite smoke -q -->
<!-- Confirm core-bootstrap skill completed successfully -->
```
---
## Modules Touched
<!-- List every file modified, created, or deleted this session. -->
| File | Change type | Summary |
|---|---|---|
| | | |
---
## Invariants Verified (Versor Coherence Guardian + Core)
<!-- For each relevant invariant, state how it was confirmed. Include Versor Coherence Guardian checks. -->
| 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?
---
## Tests Run
```bash
# Commands run and their exit status:
```
---
## Open Tasks / Next Session Entry Point
<!-- Be extremely specific. "Continue the work" is not acceptable. -->
1.
2.
3.
---
## Known Hazards / Do Not Touch
<!-- Mid-refactor state, fragile areas, or steps that must complete first. -->
---
## Architectural Decisions Made This Session
<!-- Any decision affecting future sessions (operator choices, boundary calls, ADR interpretations). -->
---
## What Must Not Be Forgotten
<!-- The single most important thing the next agent must know. Write it as if this is the only document they will read. -->
**Prompt Library Reference**: See `docs/core-rd-base-prompts.md` (especially sections #7 Standing Loop Axiom Check, #8 PR Merge-Readiness Audit, and #9 Grok Build Implementation Session). Use them as standing prefixes.
---
## 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: