graff — a fast agentic coding harness in Zig: multi-provider, MCP, workflows, DGM evolution loop, TS/Python SDKs
Kernel: prompt prefix (cache HIT)
Source of truth: lean-proofs/Graff/PromptPrefix.lean.
Process kernel next to PromptCache. PromptCache is the key and the
spawn gate. This kernel is the bytes under that key: names + triggers
only, pinned once. Bodies and file: paths are illegal in the prefix.
skill load / list / rescan / turn do not rewrite it. A mid-session
rebuild that changes the catalog busts the prefix (Codex: the old
prompt must be an exact prefix of the new one).
Wording is out of Lean. The 6-cell cube is catalog kind × pin policy;
exactly one cell is cacheable (names_only × once). That is the
measured path. Showcase it with
python3 spec/conformance.py --showcase.
| catalog \ pin | once |
every_rebuild |
|---|---|---|
names_only |
HIT | miss |
with_bodies |
miss | miss |
with_paths |
miss | miss |
sequenceDiagram
participant P as prefix
P->>P: start names_only (HIT)
P->>P: skill_load (id, HIT)
P->>P: skill_list (id, HIT)
P->>P: rescan (id, HIT)
P->>P: turn (id, HIT)
P->>P: rebuild with_paths (BUST)
stateDiagram-v2
[*] --> Unpinned
Pinned --> Busted: rebuild
Unpinned --> Busted: rebuild
Unpinned --> Pinned: rebuild
Unpinned --> Busted: start
Unpinned --> Pinned: start