update-architecture-atlaslisted
Install: claude install-skill curie-eng/curie
# Update the architecture atlas
Keep `docs/architecture-atlas/` an evidence-backed, versioned view of Curie's
current architecture and accepted vision. The JSON snapshots are the source of
truth; `index.html` is a generic renderer.
## Create a version
Resolve the exact target commit and the prior registered version. Create the
new file and manifest entry with:
```bash
python3 .claude/skills/update-architecture-atlas/scripts/new_snapshot.py \
--version <version-id> \
--commit <full-target-commit> \
--branch <branch> \
--date <YYYY-MM-DD>
```
Use `--from-version` when the default snapshot is not the correct baseline.
The helper copies data; it does not claim that the copied facts are current.
Never overwrite a registered snapshot. A historical version is immutable. If
its renderer needs a compatibility fix, change the generic HTML or bump the
atlas schema with an explicit migration.
## Research the diff
Read `AGENTS.md`, `README.md`, `ARCHITECTURE.md`, and `llms.txt`, then inspect:
```bash
git diff --name-status <prior-commit>..<target-commit>
git log --oneline --decorate <prior-commit>..<target-commit>
```
Group changed paths by ownership boundary. For each affected component or
cross-component seam, read its scoped `CLAUDE.md`, `INTERFACE.md`, relevant ADRs,
and the implementation at the target commit. Use generated
`docs/interfaces.md` as an index, not as sole proof when it conflicts with code.
Update only facts that the diff can affect. Preserve untouched