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
sica-fondt/AGENTS.md
Claude 7d2b44a1e6
docs: sharpen AGENTS.md to instructions-only, map stays in docmap.yaml 
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
2026-06-22 20:21:49 +00:00

1.1 KiB
Raw Blame History

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. Claude-specific guidance: 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.