# 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`).