31 lines
1.4 KiB
Markdown
31 lines
1.4 KiB
Markdown
|
# CLAUDE.md — project instructions for AtoCore
|
||
|
|
|
||
|
|
## Session protocol
|
||
|
|
|
||
|
|
Before doing anything else in this repo, read `DEV-LEDGER.md` at the repo root. It is the shared operating memory between Claude, Codex, and the human operator — live Dalidou SHA, active plan, open P1/P2 review findings, recent decisions, and session log. The narrative docs under `docs/` sometimes lag; the ledger does not.
|
||
|
|
|
||
|
|
Before ending a session, append a Session Log line to `DEV-LEDGER.md` covering:
|
||
|
|
|
||
|
|
- which commits you produced (sha range)
|
||
|
|
- what changed at a high level
|
||
|
|
- any harness / test count deltas
|
||
|
|
- anything you overclaimed and later corrected
|
||
|
|
|
||
|
|
Bump the **Orientation** section if `live_sha`, `main_tip`, `test_count`, or `harness` changed.
|
||
|
|
|
||
|
|
`AGENTS.md` at the repo root carries the broader project principles (storage separation, deployment model, coding guidance). Read it when you need the "why" behind a constraint.
|
||
|
|
|
||
|
|
## Deploy workflow
|
||
|
|
|
||
|
|
```bash
|
||
|
|
git push origin main && ssh papa@dalidou "bash /srv/storage/atocore/app/deploy/dalidou/deploy.sh"
|
||
|
|
```
|
||
|
|
|
||
|
|
The deploy script self-verifies via `/health` build_sha — if it exits non-zero, do not assume the change is live.
|
||
|
|
|
||
|
|
## Working model
|
||
|
|
|
||
|
|
- Claude builds; Codex audits. No parallel work on the same files.
|
||
|
|
- P1 review findings block further `main` commits until acknowledged in the ledger's **Open Review Findings** table.
|
||
|
|
- Codex branches must fork from `origin/main` (no orphan commits that require `--allow-unrelated-histories`).
|