49 lines
1.8 KiB
Markdown
49 lines
1.8 KiB
Markdown
# LANE HANDOVER LOG
|
|
|
|
Coordination file between lanes (Opus 4.8 execution sessions) and the reviewer
|
|
(Fable). **Append-only** — never edit or delete previous blocks. Newest block at the
|
|
BOTTOM. Push after every session so the reviewer can see state remotely.
|
|
|
|
## Protocol
|
|
|
|
1. Before starting work: read this whole file + your lane file in `lanes/` +
|
|
`docs/CONTRACTS.md`. Check for a REVIEW block addressed to your lane — it
|
|
overrides your lane file where they conflict.
|
|
2. Work only inside your lane's owned directories (see BUILD_PLAN.md §2).
|
|
3. End of session: append a SESSION block (template below), commit, push your
|
|
`lane/<name>` branch.
|
|
4. Never merge to main — the reviewer does that.
|
|
5. Blocked on a contract ambiguity? Don't stall and don't silently change the
|
|
contract: stub locally with `// TODO(contract):`, log a CONTRACT CHANGE REQUEST
|
|
below, keep moving.
|
|
|
|
## SESSION block template
|
|
|
|
```markdown
|
|
---
|
|
### SESSION — <LANE-NAME> — <date> <time>
|
|
**Branch/commits:** lane/<name> @ <short-sha>..<short-sha>
|
|
**Done:** bullet list of what actually works now (be honest — "renders but untested" ≠ "done")
|
|
**How to see it:** exact command + what to click (e.g. `npm run dev` → press D → deny 3 patrons)
|
|
**Tests:** X passing / Y failing (name the failures)
|
|
**Broke / known-wonky:** anything you left imperfect
|
|
**Contract change requests:** none | numbered list with justification
|
|
**Questions for reviewer:** none | numbered list
|
|
**Next session should:** bullet list
|
|
```
|
|
|
|
## REVIEW block template (reviewer only)
|
|
|
|
```markdown
|
|
---
|
|
### REVIEW — Fable — <date>
|
|
**Reviewed:** <lanes/commits>
|
|
**Merged to main:** <yes/no + sha>
|
|
**Contract decisions:** rulings on any open change requests
|
|
**Instructions for <LANE>:** what to do next / what to fix first
|
|
```
|
|
|
|
---
|
|
|
|
*(log starts below)*
|