From 85a781368a07545fffff8f909442601f0f32317f Mon Sep 17 00:00:00 2001 From: autonomic-bot Date: Thu, 11 Jun 2026 20:57:03 +0000 Subject: [PATCH] machine-docs: move all per-phase coordination files out of repo root STATUS/BACKLOG/REVIEW/JOURNAL for bsky/conc/dstamp/kuma/lvl5/mailu/rcust/shot (32 files) were at the repo root; move them into machine-docs/ to match the mandated file-location rule (DECISIONS/DEFERRED/INBOX + older phases already live there). AGENTS.md gains an explicit File-location rule. No content change. Co-Authored-By: Claude Opus 4.8 --- AGENTS.md | 8 ++++++++ BACKLOG-bsky.md => machine-docs/BACKLOG-bsky.md | 0 BACKLOG-conc.md => machine-docs/BACKLOG-conc.md | 0 BACKLOG-dstamp.md => machine-docs/BACKLOG-dstamp.md | 0 BACKLOG-kuma.md => machine-docs/BACKLOG-kuma.md | 0 BACKLOG-lvl5.md => machine-docs/BACKLOG-lvl5.md | 0 BACKLOG-mailu.md => machine-docs/BACKLOG-mailu.md | 0 BACKLOG-rcust.md => machine-docs/BACKLOG-rcust.md | 0 BACKLOG-shot.md => machine-docs/BACKLOG-shot.md | 0 JOURNAL-bsky.md => machine-docs/JOURNAL-bsky.md | 0 JOURNAL-conc.md => machine-docs/JOURNAL-conc.md | 0 JOURNAL-dstamp.md => machine-docs/JOURNAL-dstamp.md | 0 JOURNAL-kuma.md => machine-docs/JOURNAL-kuma.md | 0 JOURNAL-lvl5.md => machine-docs/JOURNAL-lvl5.md | 0 JOURNAL-mailu.md => machine-docs/JOURNAL-mailu.md | 0 JOURNAL-rcust.md => machine-docs/JOURNAL-rcust.md | 0 JOURNAL-shot.md => machine-docs/JOURNAL-shot.md | 0 REVIEW-bsky.md => machine-docs/REVIEW-bsky.md | 0 REVIEW-conc.md => machine-docs/REVIEW-conc.md | 0 REVIEW-dstamp.md => machine-docs/REVIEW-dstamp.md | 0 REVIEW-kuma.md => machine-docs/REVIEW-kuma.md | 0 REVIEW-lvl5.md => machine-docs/REVIEW-lvl5.md | 0 REVIEW-mailu.md => machine-docs/REVIEW-mailu.md | 0 REVIEW-rcust.md => machine-docs/REVIEW-rcust.md | 0 REVIEW-shot.md => machine-docs/REVIEW-shot.md | 0 STATUS-bsky.md => machine-docs/STATUS-bsky.md | 0 STATUS-conc.md => machine-docs/STATUS-conc.md | 0 STATUS-dstamp.md => machine-docs/STATUS-dstamp.md | 0 STATUS-kuma.md => machine-docs/STATUS-kuma.md | 0 STATUS-lvl5.md => machine-docs/STATUS-lvl5.md | 0 STATUS-mailu.md => machine-docs/STATUS-mailu.md | 0 STATUS-rcust.md => machine-docs/STATUS-rcust.md | 0 STATUS-shot.md => machine-docs/STATUS-shot.md | 0 33 files changed, 8 insertions(+) rename BACKLOG-bsky.md => machine-docs/BACKLOG-bsky.md (100%) rename BACKLOG-conc.md => machine-docs/BACKLOG-conc.md (100%) rename BACKLOG-dstamp.md => machine-docs/BACKLOG-dstamp.md (100%) rename BACKLOG-kuma.md => machine-docs/BACKLOG-kuma.md (100%) rename BACKLOG-lvl5.md => machine-docs/BACKLOG-lvl5.md (100%) rename BACKLOG-mailu.md => machine-docs/BACKLOG-mailu.md (100%) rename BACKLOG-rcust.md => machine-docs/BACKLOG-rcust.md (100%) rename BACKLOG-shot.md => machine-docs/BACKLOG-shot.md (100%) rename JOURNAL-bsky.md => machine-docs/JOURNAL-bsky.md (100%) rename JOURNAL-conc.md => machine-docs/JOURNAL-conc.md (100%) rename JOURNAL-dstamp.md => machine-docs/JOURNAL-dstamp.md (100%) rename JOURNAL-kuma.md => machine-docs/JOURNAL-kuma.md (100%) rename JOURNAL-lvl5.md => machine-docs/JOURNAL-lvl5.md (100%) rename JOURNAL-mailu.md => machine-docs/JOURNAL-mailu.md (100%) rename JOURNAL-rcust.md => machine-docs/JOURNAL-rcust.md (100%) rename JOURNAL-shot.md => machine-docs/JOURNAL-shot.md (100%) rename REVIEW-bsky.md => machine-docs/REVIEW-bsky.md (100%) rename REVIEW-conc.md => machine-docs/REVIEW-conc.md (100%) rename REVIEW-dstamp.md => machine-docs/REVIEW-dstamp.md (100%) rename REVIEW-kuma.md => machine-docs/REVIEW-kuma.md (100%) rename REVIEW-lvl5.md => machine-docs/REVIEW-lvl5.md (100%) rename REVIEW-mailu.md => machine-docs/REVIEW-mailu.md (100%) rename REVIEW-rcust.md => machine-docs/REVIEW-rcust.md (100%) rename REVIEW-shot.md => machine-docs/REVIEW-shot.md (100%) rename STATUS-bsky.md => machine-docs/STATUS-bsky.md (100%) rename STATUS-conc.md => machine-docs/STATUS-conc.md (100%) rename STATUS-dstamp.md => machine-docs/STATUS-dstamp.md (100%) rename STATUS-kuma.md => machine-docs/STATUS-kuma.md (100%) rename STATUS-lvl5.md => machine-docs/STATUS-lvl5.md (100%) rename STATUS-mailu.md => machine-docs/STATUS-mailu.md (100%) rename STATUS-rcust.md => machine-docs/STATUS-rcust.md (100%) rename STATUS-shot.md => machine-docs/STATUS-shot.md (100%) 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