reliquary/plugins/spire/skills/implementation/references/run-log.md

Run log and handoff notes

The run log is the record of a build: one file per build plan, in the workpad's reports/ folder (name it per the workpad skill, e.g. <YYYY-MM-DD-hh>-<slug>-run.md). Each phase appends to it. The phase reviewer reads it; a successor Athanor starts from it.

Rules:

• Take every time from date when you write it. Never estimate or count forward by feel.
• Durations in summaries come from git commit times.
• Stamp the exact model id from your system prompt. If you dispatched an agent and its id is unknown, write "unknown", not a guess.
• Totals stay provisional until the phase review, fix pass and re-check have closed.

Header

# Run log — <plan title>

- Plan: <path>  ·  Build plan: <path>
- Branch: <branch>  ·  Start commit: <hash>
- Trunk notes: <path>
- Athanor: <model id>  ·  Session journal: <path>

Per phase

## Phase <N> — <title>

| Block | Owner (model id) | Commit | Tokens (if known) |
|---|---|---|---|

Handoff note (one per block, written by the block's owner)

A few lines per block: findings, not narration. "none" is the normal answer for deviations and flags, and a real deviation or doubt is never left out.

### Block <N.M> — <title>

- Model: <exact id>
- Start / end: <`date` output> / <`date` output>
- Done: <what changed, in one or two lines>
- Deviations from plan: <what, and why, including size well over the plan's estimate> — or "none"
- Flagged for review: <a point you are unsure of, e.g. a semantic the plan left open> — or "none"
- Left for later: <work deferred to a later block or phase>
- Expected broken: <areas that do not build or pass yet, and which block fixes them>
- Commits: <hashes>

Phase close (written by the Athanor)

### Phase <N> close

- Gate: <command> — <result>
- Tests: <command> — <result> (fallout fixed in block <N.M>)
- Flags for the reviewer: the deviations and flags from the block notes above, one line each with its block — or "none" when the notes have none.
- Not run / untested: <behaviour the plan names that no test or gate ran> — or "none"
- Status: provisional until review, fix pass and re-check close.

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)

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.