mirror of
https://github.com/SHOGGOTH-SECTOR/sica-fondt.git
synced 2026-07-31 08:06:26 +00:00
Reorg step 2: move CLAUDE.md into core/, fix signpost refs
Move the canonical working-agreements file to core/CLAUDE.md (preserving history) and leave a thin root CLAUDE.md pin that imports it so the invariants still auto-load at the repo root. Update ONBOARDING.md's stale docs/ paths to core/docs/. The move also fixes the core/src/*/AGENTS.md links that pointed at ../../CLAUDE.md. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_015hmgREHNsxYCuim33yUF2c
This commit is contained in:
Claude
parent
b6bcab794f
commit
7780617762
37
CLAUDE.md
37
CLAUDE.md
@ -1,37 +1,6 @@
|
|||||||
# CLAUDE.md
|
# CLAUDE.md
|
||||||
|
|
||||||
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]
|
Working agreements, build/run, and the invariants (S1/S2/S3) for sica-fondt now
|
||||||
|
live in [`core/CLAUDE.md`](core/CLAUDE.md). This root file is only a pin.
|
||||||
|
|
||||||
## What this is
|
@core/CLAUDE.md
|
||||||
|
|
||||||
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.
|
|
||||||
|
|
||||||
## Working agreements
|
|
||||||
|
|
||||||
- **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.
|
|
||||||
- **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. Saves us all some time.
|
|
||||||
|
|
||||||
## Build & run
|
|
||||||
|
|
||||||
Use the `run-sica-fondt` skill (`.claude/skills/run-sica-fondt/`) — its `smoke.sh` builds and runs every executable unit and asserts output:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
.claude/skills/run-sica-fondt/smoke.sh
|
|
||||||
```
|
|
||||||
|
|
||||||
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.
|
|
||||||
|
|
||||||
## Invariants — do not violate
|
|
||||||
|
|
||||||
- **S1:** all external traffic crosses the Ada border (D1) first; never route around it.
|
|
||||||
- **S2:** never reclassify a message's provenance.
|
|
||||||
- **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.
|
|
||||||
|
|
||||||
## Docs map
|
|
||||||
|
|
||||||
- `README.md` — the project and its intent.
|
|
||||||
- `docs/` — architecture (`bus-topology.md`, `gen03_state_of_architecture.md`, …).
|
|
||||||
- `ONBOARDING.md` — new-teammate setup and walkthrough.
|
|
||||||
- `AGENTS.md` — directions for how to proceed.
|
|
||||||
- `docmap.yaml` — machine-readable index: doc routing, organ list.
|
|
||||||
|
|||||||
@ -43,7 +43,7 @@ Your first task: get the project running end-to-end and read the map. Not sure w
|
|||||||
|
|
||||||
1. Open the repo and let the SessionStart hook finish installing toolchains.
|
1. Open the repo and let the SessionStart hook finish installing toolchains.
|
||||||
2. Run the smoke driver to confirm everything builds and runs: `.claude/skills/run-sica-fondt/smoke.sh` — you want `smoke: ALL GREEN`.
|
2. Run the smoke driver to confirm everything builds and runs: `.claude/skills/run-sica-fondt/smoke.sh` — you want `smoke: ALL GREEN`.
|
||||||
3. Read `README.md`, and `docs/` (start with `docs/bus-topology.md` and `docs/gen03_state_of_architecture.md`) to understand the organ/border model (Ichor bus → Ada D1 border → inner brain; the COBOL invariant vault).
|
3. Read `README.md`, and `core/docs/` (start with `core/docs/bus-topology.md` and `core/docs/gen03_state_of_architecture.md`) to understand the organ/border model (Ichor bus → Ada D1 border → inner brain; the COBOL invariant vault).
|
||||||
4. Pick up a small design-sync or build task from there. Ask Claude to walk you
|
4. Pick up a small design-sync or build task from there. Ask Claude to walk you
|
||||||
through any unit — it has the `run-sica-fondt` skill loaded.
|
through any unit — it has the `run-sica-fondt` skill loaded.
|
||||||
|
|
||||||
|
|||||||
37
core/CLAUDE.md
Normal file
37
core/CLAUDE.md
Normal file
@ -0,0 +1,37 @@
|
|||||||
|
# CLAUDE.md
|
||||||
|
|
||||||
|
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]
|
||||||
|
|
||||||
|
## What this is
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
|
## Working agreements
|
||||||
|
|
||||||
|
- **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.
|
||||||
|
- **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. Saves us all some time.
|
||||||
|
|
||||||
|
## Build & run
|
||||||
|
|
||||||
|
Use the `run-sica-fondt` skill (`.claude/skills/run-sica-fondt/`) — its `smoke.sh` builds and runs every executable unit and asserts output:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
.claude/skills/run-sica-fondt/smoke.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
|
## Invariants — do not violate
|
||||||
|
|
||||||
|
- **S1:** all external traffic crosses the Ada border (D1) first; never route around it.
|
||||||
|
- **S2:** never reclassify a message's provenance.
|
||||||
|
- **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.
|
||||||
|
|
||||||
|
## Docs map
|
||||||
|
|
||||||
|
- `README.md` — the project and its intent.
|
||||||
|
- `docs/` — architecture (`bus-topology.md`, `gen03_state_of_architecture.md`, …).
|
||||||
|
- `ONBOARDING.md` — new-teammate setup and walkthrough.
|
||||||
|
- `AGENTS.md` — directions for how to proceed.
|
||||||
|
- `docmap.yaml` — machine-readable index: doc routing, organ list.
|
||||||
Loading…
x
Reference in New Issue
Block a user