mirror of
https://github.com/SHOGGOTH-SECTOR/sica-fondt.git
synced 2026-07-31 16:16:26 +00:00
7d2b44a1e6
Clean role split: AGENTS.md = instructions (nesting rule + behavioral rules), docmap.yaml = map (locations). Dropped the inline organ-structure description; it now points at docmap.yaml -> organs instead of restating the map in prose. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_015hmgREHNsxYCuim33yUF2c
22 lines
1.1 KiB
Markdown
22 lines
1.1 KiB
Markdown
# 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.
|