Update CLAUDE.md for the split docs and the Laguna handoff
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This commit is contained in:
@@ -4,19 +4,24 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
|
|||||||
|
|
||||||
## Current state
|
## Current state
|
||||||
|
|
||||||
Boxmaker is a sovereign personal agent harness written in Rust. As of this file's creation the
|
Boxmaker is a sovereign personal agent harness written in Rust. There is no Rust code yet. Work
|
||||||
repo holds only `docs/design.md`: no code, no Cargo workspace, no Makefile, and no git history.
|
proceeds one milestone per session (M0 to M7, table in `docs/milestones.md`). M0 is mostly done;
|
||||||
Work proceeds one milestone per session (M0–M7, table in `docs/design.md` Part 3). Before doing
|
check for `AGENTS.md` and `Cargo.toml` to see whether M1 has started.
|
||||||
anything, check which milestone artifacts exist (`spike/`, `docs/inference-contract.md`,
|
|
||||||
`AGENTS.md`, `Cargo.toml`) to work out where the project is.
|
|
||||||
|
|
||||||
`docs/design.md` is the binding design brief. Part 1 is the design; Part 2 is the session 1 prompt
|
- `docs/design.md` is the binding design brief. If it looks wrong or conflicts with a measurement,
|
||||||
(M0 spike plus M1 skeleton); Part 3 is the milestone table and the per-milestone prompt template.
|
stop and say so. Changes to it land as their own commit and are recorded in `docs/decisions.md`,
|
||||||
If the brief looks wrong or conflicts with a measurement, stop and say so. Don't work around it.
|
which also lists proposed changes that are not yet applied.
|
||||||
Propose changes to `docs/design.md` as their own commit before building on them.
|
- `docs/inference-contract.md` holds the M0 measurements from straylight. Where it and the brief
|
||||||
|
disagree, the measurements are newer.
|
||||||
|
- `spike/` is throwaway measurement code, not harness code.
|
||||||
|
|
||||||
Once they exist, read `AGENTS.md` (project standards, how to run the gate, how to verify against
|
Roles: implementation is done by Laguna S 2.1 through OpenCode on straylight, which reads
|
||||||
straylight) and `docs/inference-contract.md` (M0 measurements) alongside the brief.
|
`AGENTS.md`. Design, specs, measurement and review are done here. Write plans for Laguna as small
|
||||||
|
closed tasks: exact paths, given type signatures, verified crate APIs, tests specified first, and
|
||||||
|
"stop and report" instead of judgement calls. The model the harness serves is Ornith-1.5-35B-A3B.
|
||||||
|
|
||||||
|
The inference server is shared with other sessions. Before using Ornith slot 1 or sending unpinned
|
||||||
|
requests, check `GET /slots?model=ornith-1.5-35b-a3b` so you do not evict someone's cache.
|
||||||
|
|
||||||
## Commands (planned in M1, not yet present)
|
## Commands (planned in M1, not yet present)
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user