Update and rename core/agents.md to AGENTS.MD

Signed-off-by: gravermistakes <evermoor.a.a@gmail.com>
This commit is contained in:
2026-06-23 10:32:41 -07:00
committed by GitHub
parent 21b0388476
commit 6a6f4afb31
-21
View File
@@ -1,21 +0,0 @@
# AGENTS.md
**Instructions** for agents (any tool) working in this repo. The **map** — where
everything lives: read-order, doc routing, the organ list, build commands — is
[`docmap.yaml`](docmap.yaml). Claude-specific guidance: [`CLAUDE.md`](CLAUDE.md).
## How these files work
- AGENTS.md files are **instructions, and they nest**: an agent reads the
*nearest* one walking up from the file it's editing. Each organ has its own
(listed in `docmap.yaml` → `organs`).
- Keep each file to **instructions for its scope**, non-overlapping. Locations
belong in `docmap.yaml`, not in prose here — don't duplicate the map.
## Rules
- **Design before code.** The design docs are the source of truth; code follows.
- **Honor the invariants** (S1/S2/S3 — text in `CLAUDE.md`): the Ada border and
the COBOL vault are not optional.
- **Verify, then commit.** Run the smoke driver; commit + push before leaving
(the container is ephemeral).
- **Keep the map honest.** Add an organ or move a doc → update `docmap.yaml`.
Keep `CLAUDE.md` ≤200 lines and this file ≤100.