// documentation
memory-atlas documentation
memory-atlas is a per-repo knowledge atlas for coding agents: plain-markdown zone cards with an honest verifiedAt freshness signal. npm ships the engine; your mind vault lives in the repo as data.
Site: atlas.muslewski.com · npm: memory-atlas
Start here
| Path | For |
|---|---|
| On-ramp | Wire CLAUDE.md / AGENTS.md, SessionStart hooks, skills after atlas init |
| Adoption | Brownfield migrate: existing docs/ADRs/mind → Atlas shape |
| Configuration | atlas.config.json field reference |
| CI recipe | atlas check + index-in-sync in GitHub Actions |
| Works with | Fleet siblings (sage, herald, oracle, armory, ferry) |
Doctrine (short)
- Verified, not believed — claims tie to git (
owns.globs,verifiedAt), not session transcripts. - Map vs ledger — present-tense zones separate from frozen decisions/specs/plans.
- Recollection on finish — update + stamp zones in the same change as the code.
- Solo-first — zero sibling packages required; interop is optional file contracts.
Where other knowledge lives
| Kind | Location |
|---|---|
| Public product docs | docs/ (this tree) |
| Architecture mind (dogfood) | atlas/ — zones, decisions, specs, plans |
| Normative product spec | SPEC.md (repo root — not duplicated here) |
| Agent on-ramp (this repo) | CLAUDE.md / AGENTS.md |
| Changelog | CHANGELOG.md |
Design specs and implementation plans for this toolkit live under atlas/specs/ and atlas/plans/ (and advisor-plans for program tracking) — not under public docs/.