🤖 gremlins: SKILL.md, Athanor procedure, implementation skill, run-log template

This commit is contained in:
2026-10-16 22:06:33 +02:00
parent 1de1029dc6
commit a5dfaefac9
4 changed files with 167 additions and 21 deletions
@@ -17,20 +17,27 @@ Rules:
- Plan: <path> · Build plan: <path>
- Branch: <branch> · Start commit: <hash>
- Trunk notes: <path>
- Gremlins: <state dir> (or "none: <reason>")
- Athanor: <model id> · Session journal: <path>
```
A successor Athanor finds the state dir on the `Gremlins:` line and adopts it (`list`); it never re-runs `init`.
## Per phase
```markdown
## Phase <N> — <title>
| Block | Owner (model id) | Commit | Tokens (if known) |
|---|---|---|---|
| Block | Owner (model id from modelUsage) | Session | Commit | in | out | cache write | cache read | cost Δ |
|---|---|---|---|---|---|---|---|---|
```
Gremlin blocks: the row comes from `usage --block <id> --format md`. Fresh-agent blocks: owner = the model id the agent stamped, Session `—`, the usage cells `—`, and the harness's token total in the block's handoff note.
## Handoff note (one per block, written by the block's owner)
Same format for everyone. A gremlin writes it to `notes/<block>.md` in the state dir and the Athanor appends it here; a fresh agent writes it here directly.
```markdown
### Block <N.M> — <title>
@@ -51,6 +58,8 @@ Rules:
- Gate: <command> — <result>
- Tests: <command> — <result> (fallout fixed in block <N.M>)
- Usage: the `usage --phase <N> --format md` table and its three lines (cold starts, cache-hit ratio, priced total)
- Base state: from `list` (the active base, its warmth, rebase/re-train flags)
- Flags for the reviewer: every deviation and every "flagged for review" line above, one per bullet, with its block.
- Not run / untested: <anything the tests do not cover>
- Status: provisional until review, fix pass and re-check close.
@@ -58,6 +67,6 @@ Rules:
After the review, Igor (or the fixer) appends the review report path, the fix-pass commits, the re-check result, and the minors logged as follow-ups.
## Trunk notes (written by the Athanor at intake)
## Trunk notes (written by the base at training; by a fresh agent where gremlins are unavailable)
Short, for the next agent that has not read the code: key files and seams, invariants the phase touches, every consumer of a changed semantic, the gate command, known traps. A page, not a design document.