CLAUDE.md — Claude-tool doorway #

AGENT.md is the single binding session entry point. Read and follow it before changing anything. This doorway keeps only the current, easy-to-miss guardrails; it does not replace the full rule set.

For quick orientation: DESIGN.md is navigation only, the whole typed wiki is the design corpus, wiki/process/ROADMAP.md dispatches work, and wiki/process/meta.md defines the corpus format.

Repository worktrees live at .Codex/worktrees/<task> on a worktree-<task> branch (override the root with MISALIGNED_WORKTREE_ROOT). Never edit the shared primary checkout. If a patch tool resolves paths from that checkout, address the task worktree explicitly and verify both worktree statuses afterward.

Current guardrails #

• Start repository work with the tick: tools/tick-brief.sh is the intake (commits, activity, status, decision labels, findings queue, stalest coverage in one shot); work the queues before fresh audit and trace every tick in the ledger. Activity overlap is advisory, not a lock; worktrees isolate edits and final rebase/check reconciles them.
• This is a Cargo workspace, not a feature-switched root crate. Product code lives in crates/misaligned-{core,terminal,bevy,assets}/; there is no root product src/ tree and no bevy_ui feature path. Use package-aware commands such as cargo test -p misaligned-core, cargo build -p misaligned-bevy --bin misaligned-bevy, or the proportional ./tools/check.sh --docs|--lib|--frontend gate.
• The live player machine grammar is WORK / THINK / LIE. Relay is non-delegable graph infrastructure; Research and Operations are retired machine modes, not current player assignments. Save format is currently v29; the retired mode spellings load through serde aliases (parity restored 2026-07-11), and save.rs remains the authority on what each version migrates.
• Any change to crates/ must amend its owning Type: law or Type: spec in wiki/ and carry a Defense. Documentation work updates stale knowledge, adds a dated wiki/log/ entry, then runs tools/ledger_index.sh; never hand-edit generated wiki/log/DEVLOG.md or wiki/process/specs.md.

Project agents #

• Trace — Cameron's Letta agent holding deep Misaligned context (design history, collaboration patterns, dispatch sequencing). Consult before large interface/spec work and for cross-session continuity: letta -p "<prompt>" --agent agent-7039aebc-8ae3-4688-8ca3-31c4ade526f1 (--new starts a conversation, --conv <id> resumes one). Headless mode needs LETTA_API_KEY — sourced from the repo-root .env (never stage or print it).