mirror of
https://github.com/SHOGGOTH-SECTOR/sica-fondt.git
synced 2026-07-31 08:06:26 +00:00
d784a92f75
AGENTS.md was carrying the read-order + routing table inline; moved that to an independent machine-readable docmap.yaml (read_order, routing, design_docs, organs with build cmds, invariants, smoke). AGENTS.md slims to a prose signpost (54->28 lines) pointing at it; CLAUDE.md docs-map lists it. YAML validated. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_015hmgREHNsxYCuim33yUF2c
57 lines
2.5 KiB
YAML
57 lines
2.5 KiB
YAML
# docmap.yaml — directory & document index for sica-fondt.
|
|
#
|
|
# The independent, machine-readable map referenced by AGENTS.md. AGENTS.md stays
|
|
# prose (scope + rules); this stays data (where things are). Keep in sync with
|
|
# the tree. Invariant text is authoritative in CLAUDE.md — mirrored here as a
|
|
# pointer only.
|
|
|
|
docs:
|
|
read_order: # newcomer reading path
|
|
- README.md # what sica-fondt is
|
|
- SOUL.md # intent and principles — the "why"
|
|
- docs/ # architecture in detail
|
|
- CLAUDE.md # working agreements, build/run, invariants
|
|
- ONBOARDING.md # newcomer setup + first task
|
|
|
|
routing: # which doc for which task
|
|
high_level_overview: [README.md, SOUL.md]
|
|
architecture: [docs/bus-topology.md, docs/gen03_state_of_architecture.md]
|
|
build_run_test: .claude/skills/run-sica-fondt/ # smoke.sh
|
|
rules_before_editing: CLAUDE.md
|
|
onboard_teammate: ONBOARDING.md
|
|
find_which_doc: AGENTS.md # the prose signpost; this file is its index
|
|
|
|
design_docs:
|
|
docs/bus-topology.md: Ichor bus and organ wiring
|
|
docs/gen03_state_of_architecture.md: current architectural state
|
|
docs/gen03_body.md: body model
|
|
docs/gen03_self.md: self model
|
|
docs/plans/: forward-looking plans
|
|
|
|
# Organs — deployable units, each with its own scoped AGENTS.md (nearest-wins).
|
|
organs:
|
|
- path: src/ichor
|
|
agents_md: src/ichor/AGENTS.md
|
|
lang: pony
|
|
role: Ichor perfusion bus (outer transport); S1 membrane screens external traffic
|
|
build: "ponyc src/ichor -o build && ./build/ichor" # from repo root
|
|
- path: src/endocrine
|
|
agents_md: src/endocrine/AGENTS.md
|
|
lang: [r, octave]
|
|
role: endocrine array — R Drive-Box + Octave ETR
|
|
build: "src/endocrine/run_tests.sh ; src/endocrine/etr/run_etr_tests.sh"
|
|
- path: mafiabot_core
|
|
agents_md: mafiabot_core/AGENTS.md
|
|
lang: [ada, cobol]
|
|
role: Ada border (D1) — all traffic crosses here first; COBOL invariant vault in src/trust
|
|
build: "cd mafiabot_core && alr -n build" # not bare gprbuild
|
|
|
|
# Repo-wide invariants — authoritative text in CLAUDE.md.
|
|
invariants:
|
|
S1: all external traffic crosses the Ada border (D1) first
|
|
S2: never reclassify a message's provenance
|
|
S3: the COBOL invariant-law vault is immutable at runtime
|
|
|
|
# One harness builds and runs every executable unit; want "smoke: ALL GREEN".
|
|
smoke: .claude/skills/run-sica-fondt/smoke.sh
|