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

Update CLAUDE.md

Browse Source 
this is 90% canon now
This commit is contained in:
gravermistakes 2026-06-22 13:42:19 -07:00 committed by GitHub
parent 7d2b44a1e6
commit b1846a0ec8
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 13 additions and 30 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

43
CLAUDE.md
View File

@ -1,54 +1,37 @@
# CLAUDE.md # CLAUDE.md
Guidance for Claude Code when working in this repository. Keep this file under Keep this file under **200 lines**. For team setup and a newcomer walkthrough, see [`ONBOARDING.md`](ONBOARDING.md); for how the docs fit together and which to read when, see [`AGENTS.md`](AGENTS.md).[;human note: fix the hyperlinks|to:claude]
**200 lines**. For team setup and a newcomer walkthrough, see
[`ONBOARDING.md`](ONBOARDING.md); for how the docs fit together and which to
read when, see [`AGENTS.md`](AGENTS.md).
## What this is ## What this is
sica-fondt is a **design-first, polyglot architecture**: an Ichor perfusion bus sica-fondt is a **design-first, polyglot organism**: a Pony perfusion bus (Ichor) feeds an Ada/SPARK border (D1). The design docs are the source; the code follows them usually.
(Pony) feeds an Ada/SPARK border (D1), which fronts the inner brain, with a
COBOL invariant-law vault as the constitution. The design docs are the source of
truth; the code follows them.
## Working agreements ## Working agreements
- **You're the dev.** When details are missing or a decision is open, make the - **You're the dev.** When details are missing or a decision is open, make a reasonable reasonable call and fill in concrete details — aim to leave no placeholders, and only delay ifnsomething is genuinely ambiguous.
reasonable call and fill in concrete details — don't leave placeholders or - **Verify, then commit.** After generating or editing, confirm it works (build / run / `run-sica-fondt` smoke), then commit with a descriptive message. Commit and push before ending a session — the container is ephemeral.
stall to ask, unless something is genuinely ambiguous. - **Design before code.** If something feels ambiguous, the answer is usually already written in `docs/`. Sync the design first. Saves us all some time.
- **Verify, then commit.** After generating or editing, confirm it works (build
/ run / `run-sica-fondt` smoke), then commit with a descriptive message.
Commit and push before ending a session — the container is ephemeral.
- **Design before code.** If something feels ambiguous, the answer is usually
already written in `docs/`. Sync the design first.
## Build & run ## Build & run
Use the `run-sica-fondt` skill (`.claude/skills/run-sica-fondt/`) — its Use the `run-sica-fondt` skill (`.claude/skills/run-sica-fondt/`) — its `smoke.sh` builds and runs every executable unit and asserts output:
`smoke.sh` builds and runs every executable unit and asserts output:
```bash ```bash
.claude/skills/run-sica-fondt/smoke.sh # want: smoke: ALL GREEN .claude/skills/run-sica-fondt/smoke.sh
``` ```
Per-unit commands and gotchas live in that skill's `SKILL.md`. Toolchains Per-unit commands and gotchas live in that unit's `AGENTS.md`. Toolchains (ponyc/Alire/GnuCOBOL) are reinstalled each session by the SessionStart hook `.claude/hooks/install-toolchains.sh`; if `ponyc` isn't found,`export PATH=/root/.local/share/ponyup/bin:$PATH`. If a bew toolchain is needed, first add it to sessionStart hook.
(ponyc/Alire/GnuCOBOL) are reinstalled each session by the SessionStart hook
`.claude/hooks/install-toolchains.sh`; if `ponyc` isn't found,
`export PATH=/root/.local/share/ponyup/bin:$PATH`.
## Invariants — do not violate ## Invariants — do not violate
- **S1:** all external traffic crosses the Ada border (D1) first; never route - **S1:** all external traffic crosses the Ada border (D1) first; never route around it.
around it.
- **S2:** never reclassify a message's provenance. - **S2:** never reclassify a message's provenance.
- **S3 / vault:** the COBOL invariant-law vault (Invariant 0, the culpability - **S3 / vault:** the COBOL invariant-law vault (Invariant 0, the culpability anchor; 01, "harm" "less";) is immutable at runtime — don't edit it unless explicitly directed and only as such.
anchor; 01, minimize harm) is immutable at runtime — don't edit it casually.
## Docs map ## Docs map
- `README.md`, `SOUL.md` — the project and its intent. - `README.md` — the project and its intent.
- `docs/` — architecture (`bus-topology.md`, `gen03_state_of_architecture.md`, …). - `docs/` — architecture (`bus-topology.md`, `gen03_state_of_architecture.md`, …).
- `ONBOARDING.md` — new-teammate setup and walkthrough. - `ONBOARDING.md` — new-teammate setup and walkthrough.
- `AGENTS.md` — prose signpost for how the docs fit together. - `AGENTS.md` — directions for how to proceed.
- `docmap.yaml` — machine-readable index: read-order, doc routing, organ list. - `docmap.yaml` — machine-readable index: doc routing, organ list.