🤖 gremlins: SKILL.md, Athanor procedure, implementation skill, run-log template
This commit is contained in:
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user