diff --git a/AGENTS.md b/AGENTS.md index db63897..aa2c965 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -3,6 +3,14 @@ Working notes for agents (and humans) modifying the cc-ci server. See `README.md` for what the server does and `machine-docs/` for the build's living state (`DECISIONS.md`, `DEFERRED.md`, `STATUS-*.md`). +## File-location rule (mandatory) + +ALL coordination / loop-state files live under **`machine-docs/`**, NEVER the repo root. That means +the phase-namespaced `STATUS-*.md`, `BACKLOG-*.md`, `REVIEW-*.md`, `JOURNAL-*.md`, the shared +`DECISIONS.md` / `DEFERRED.md`, and the `ADVERSARY-INBOX.md` / `BUILDER-INBOX.md` side-channels. +Create `machine-docs/` if missing; if you ever find one of these at the root, `git mv` it into +`machine-docs/`. (The repo root is for actual server code/config — `runner/`, `tests/`, `nix/`, etc.) + ## Testing cadence Two kinds of tests live here — run them on **different** cadences: diff --git a/BACKLOG-bsky.md b/machine-docs/BACKLOG-bsky.md similarity index 100% rename from BACKLOG-bsky.md rename to machine-docs/BACKLOG-bsky.md diff --git a/BACKLOG-conc.md b/machine-docs/BACKLOG-conc.md similarity index 100% rename from BACKLOG-conc.md rename to machine-docs/BACKLOG-conc.md diff --git a/BACKLOG-dstamp.md b/machine-docs/BACKLOG-dstamp.md similarity index 100% rename from BACKLOG-dstamp.md rename to machine-docs/BACKLOG-dstamp.md diff --git a/BACKLOG-kuma.md b/machine-docs/BACKLOG-kuma.md similarity index 100% rename from BACKLOG-kuma.md rename to machine-docs/BACKLOG-kuma.md diff --git a/BACKLOG-lvl5.md b/machine-docs/BACKLOG-lvl5.md similarity index 100% rename from BACKLOG-lvl5.md rename to machine-docs/BACKLOG-lvl5.md diff --git a/BACKLOG-mailu.md b/machine-docs/BACKLOG-mailu.md similarity index 100% rename from BACKLOG-mailu.md rename to machine-docs/BACKLOG-mailu.md diff --git a/BACKLOG-rcust.md b/machine-docs/BACKLOG-rcust.md similarity index 100% rename from BACKLOG-rcust.md rename to machine-docs/BACKLOG-rcust.md diff --git a/BACKLOG-shot.md b/machine-docs/BACKLOG-shot.md similarity index 100% rename from BACKLOG-shot.md rename to machine-docs/BACKLOG-shot.md diff --git a/JOURNAL-bsky.md b/machine-docs/JOURNAL-bsky.md similarity index 100% rename from JOURNAL-bsky.md rename to machine-docs/JOURNAL-bsky.md diff --git a/JOURNAL-conc.md b/machine-docs/JOURNAL-conc.md similarity index 100% rename from JOURNAL-conc.md rename to machine-docs/JOURNAL-conc.md diff --git a/JOURNAL-dstamp.md b/machine-docs/JOURNAL-dstamp.md similarity index 100% rename from JOURNAL-dstamp.md rename to machine-docs/JOURNAL-dstamp.md diff --git a/JOURNAL-kuma.md b/machine-docs/JOURNAL-kuma.md similarity index 100% rename from JOURNAL-kuma.md rename to machine-docs/JOURNAL-kuma.md diff --git a/JOURNAL-lvl5.md b/machine-docs/JOURNAL-lvl5.md similarity index 100% rename from JOURNAL-lvl5.md rename to machine-docs/JOURNAL-lvl5.md diff --git a/JOURNAL-mailu.md b/machine-docs/JOURNAL-mailu.md similarity index 100% rename from JOURNAL-mailu.md rename to machine-docs/JOURNAL-mailu.md diff --git a/JOURNAL-rcust.md b/machine-docs/JOURNAL-rcust.md similarity index 100% rename from JOURNAL-rcust.md rename to machine-docs/JOURNAL-rcust.md diff --git a/JOURNAL-shot.md b/machine-docs/JOURNAL-shot.md similarity index 100% rename from JOURNAL-shot.md rename to machine-docs/JOURNAL-shot.md diff --git a/REVIEW-bsky.md b/machine-docs/REVIEW-bsky.md similarity index 100% rename from REVIEW-bsky.md rename to machine-docs/REVIEW-bsky.md diff --git a/REVIEW-conc.md b/machine-docs/REVIEW-conc.md similarity index 100% rename from REVIEW-conc.md rename to machine-docs/REVIEW-conc.md diff --git a/REVIEW-dstamp.md b/machine-docs/REVIEW-dstamp.md similarity index 100% rename from REVIEW-dstamp.md rename to machine-docs/REVIEW-dstamp.md diff --git a/REVIEW-kuma.md b/machine-docs/REVIEW-kuma.md similarity index 100% rename from REVIEW-kuma.md rename to machine-docs/REVIEW-kuma.md diff --git a/REVIEW-lvl5.md b/machine-docs/REVIEW-lvl5.md similarity index 100% rename from REVIEW-lvl5.md rename to machine-docs/REVIEW-lvl5.md diff --git a/REVIEW-mailu.md b/machine-docs/REVIEW-mailu.md similarity index 100% rename from REVIEW-mailu.md rename to machine-docs/REVIEW-mailu.md diff --git a/REVIEW-rcust.md b/machine-docs/REVIEW-rcust.md similarity index 100% rename from REVIEW-rcust.md rename to machine-docs/REVIEW-rcust.md diff --git a/REVIEW-shot.md b/machine-docs/REVIEW-shot.md similarity index 100% rename from REVIEW-shot.md rename to machine-docs/REVIEW-shot.md diff --git a/STATUS-bsky.md b/machine-docs/STATUS-bsky.md similarity index 100% rename from STATUS-bsky.md rename to machine-docs/STATUS-bsky.md diff --git a/STATUS-conc.md b/machine-docs/STATUS-conc.md similarity index 100% rename from STATUS-conc.md rename to machine-docs/STATUS-conc.md diff --git a/STATUS-dstamp.md b/machine-docs/STATUS-dstamp.md similarity index 100% rename from STATUS-dstamp.md rename to machine-docs/STATUS-dstamp.md diff --git a/STATUS-kuma.md b/machine-docs/STATUS-kuma.md similarity index 100% rename from STATUS-kuma.md rename to machine-docs/STATUS-kuma.md diff --git a/STATUS-lvl5.md b/machine-docs/STATUS-lvl5.md similarity index 100% rename from STATUS-lvl5.md rename to machine-docs/STATUS-lvl5.md diff --git a/STATUS-mailu.md b/machine-docs/STATUS-mailu.md similarity index 100% rename from STATUS-mailu.md rename to machine-docs/STATUS-mailu.md diff --git a/STATUS-rcust.md b/machine-docs/STATUS-rcust.md similarity index 100% rename from STATUS-rcust.md rename to machine-docs/STATUS-rcust.md diff --git a/STATUS-shot.md b/machine-docs/STATUS-shot.md similarity index 100% rename from STATUS-shot.md rename to machine-docs/STATUS-shot.md