From 74f55278c26bc12275ee28a50a3c7e56c20db5eb Mon Sep 17 00:00:00 2001 From: Cameron Date: Fri, 10 Jul 2026 20:51:16 -0700 Subject: [PATCH] Update agent entrypoint guardrails MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Give tool-specific agent doorways the current workspace, machine grammar, save, and documentation rules so they do not replay retired project assumptions. 👾 Generated with [Letta Code](https://letta.com) Co-Authored-By: Letta Code --- AGENTS.md | 26 +++++++++++++++++-- CLAUDE.md | 26 +++++++++++++++++-- wiki/log/2026-07-10-agent-entrypoints.md | 32 ++++++++++++++++++++++++ wiki/log/DEVLOG.md | 5 ++++ 4 files changed, 85 insertions(+), 4 deletions(-) create mode 100644 wiki/log/2026-07-10-agent-entrypoints.md diff --git a/AGENTS.md b/AGENTS.md index b35e7cc9..a33b8251 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,8 +1,8 @@ # AGENTS.md — agent-tool doorway [AGENT.md](AGENT.md) is the single binding session entry point. Read and follow -it before changing anything; this file deliberately does not duplicate its -rules. +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](DESIGN.md) is navigation only, the whole typed [wiki](wiki/overview.md) is the design corpus, @@ -14,3 +14,25 @@ The repository worktree convention is `.Codex/worktrees/` with branch 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](wiki/process/tick.md), then inspect + `tools/claim.sh list` and `tools/project-status.py`. 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 v21; + v20/v21 deliberately dropped full old-save parity, so read `save.rs` before + promising a migration. +- 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`. diff --git a/CLAUDE.md b/CLAUDE.md index 8265c830..71140431 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,8 +1,8 @@ # CLAUDE.md — Claude-tool doorway [AGENT.md](AGENT.md) is the single binding session entry point. Read and follow -it before changing anything; this file deliberately does not duplicate its -rules. +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](DESIGN.md) is navigation only, the whole typed [wiki](wiki/overview.md) is the design corpus, @@ -14,3 +14,25 @@ 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](wiki/process/tick.md), then inspect + `tools/claim.sh list` and `tools/project-status.py`. 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 v21; + v20/v21 deliberately dropped full old-save parity, so read `save.rs` before + promising a migration. +- 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`. diff --git a/wiki/log/2026-07-10-agent-entrypoints.md b/wiki/log/2026-07-10-agent-entrypoints.md new file mode 100644 index 00000000..ea9037d5 --- /dev/null +++ b/wiki/log/2026-07-10-agent-entrypoints.md @@ -0,0 +1,32 @@ +# Agent entrypoint sync — 2026-07-10 + +``` +Type: log +``` + +## What changed + +- Updated `AGENTS.md` and `CLAUDE.md` from bare redirects into concise + compatibility doorways. `AGENT.md` remains the single binding session entry + point; the two tool-specific files now repeat only current high-risk facts. +- Recorded the Cargo workspace boundary (four `crates/misaligned-*` packages, + no root product `src/`, no `bevy_ui` path), package-aware gate examples, the + WORK/THINK/LIE player grammar, Relay's infrastructure role, and save v21's + intentionally limited old-save parity. +- Added the current documentation/log/indexing procedure so tool agents do not + hand-edit generated ledger projections. + +## Evidence + +- `AGENT.md` is the binding project entry point and owns worktree, tick, + verification, corpus, and landing procedure. +- `wiki/engineering/crate-workspace.md` owns package architecture; + `crates/misaligned-core/src/work_grid.rs` owns the three player delegations; + `crates/misaligned-core/src/save.rs` sets `SAVE_VERSION = 21`. + +## Defense + +`wiki/process/development-style.md` requires current knowledge to be repaired +when implementation makes it stale. These entrypoints are operational +documentation only; they preserve `AGENT.md` as the authoritative full rule +set. diff --git a/wiki/log/DEVLOG.md b/wiki/log/DEVLOG.md index 0b424fe9..f6f0cf67 100644 --- a/wiki/log/DEVLOG.md +++ b/wiki/log/DEVLOG.md @@ -301,6 +301,11 @@ add or amend a session log, then re-run the generator. - Intent: Remove the repository-specific prohibition on crediting AI contributors in commit messages. Cameron decided that accurate AI attribution is acceptable; the existing plain-message and explicit-staging rules remain. - Log: [wiki/log/2026-07-10-allow-ai-attribution.md](2026-07-10-allow-ai-attribution.md) +## 2026-07-10 - Agent entrypoint sync — 2026-07-10 + +- Intent: (see session log) +- Log: [wiki/log/2026-07-10-agent-entrypoints.md](2026-07-10-agent-entrypoints.md) + ## 2026-07-10 - Advisory task activity, not path ownership - Intent: Break a live coordination deadlock and remove the mechanism that created it. The action-contract task held an exclusive `crates/misaligned-bevy/src/main.rs` claim while reporting that it was blocked by eyes-camera-exposure; that prerequisite needed the same file. Machine-consu... -- 2.51.2