saint-graves/sica-fondt
1
0
Fork 0
mirror of https://github.com/SHOGGOTH-SECTOR/sica-fondt.git synced 2026-07-31 16:16:26 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: sharpen AGENTS.md to instructions-only, map stays in docmap.yaml

Browse Source 
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
This commit is contained in:
Claude 2026-06-22 20:21:49 +00:00
parent d784a92f75
commit 7d2b44a1e6
No known key found for this signature in database
1 changed files with 16 additions and 23 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
AGENTS.md
View File

@ -1,28 +1,21 @@
# AGENTS.md
How to use the documents in this repo — the prose signpost. The full
directory/document index lives in [`docmap.yaml`](docmap.yaml) (machine-readable;
start there to find which file covers what, the newcomer read-order, and the
organ list). Working agreements and invariant text: [`CLAUDE.md`](CLAUDE.md).
Keep this file lean (≤100 lines) — depth lives in the docs it points to.
**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).
## Scope & nesting
`AGENTS.md` is **hierarchical** — an agent reads the *nearest* one walking up
from the file it's editing. So this root file is the **map**; each organ owns a
scoped `AGENTS.md` with its *local* build/run/invariants (see `docmap.yaml` →
`organs` for the list and paths).
Keep scopes **non-overlapping**: the root signposts, the organs detail. Don't
restate the root in an organ file (that's how the two drift) — link up instead.
## Rules of the road
## 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 in `CLAUDE.md`) — the Ada border and the
COBOL vault are not optional.
- **Verify, then commit.** Run the smoke driver (`docmap.yaml` → `smoke`); commit
+ push before leaving (the container is ephemeral).
- **Keep the docs honest.** If you change behavior, update the doc — and the
`docmap.yaml` entry — that describes it. Keep `CLAUDE.md` ≤200 lines and this
file ≤100.
- **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.