메뉴
Use when finishing a change in a repo that has an Atlas — before ending the session or opening a PR, to keep the vault's zone cards, stamps, and ledger entries in sync with the code just changed.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Use when the user wants to adopt this knowledge base, onboard a brownfield vault, act on "atlas adopt reported unclassified notes", or migrate existing docs/mind into atlas. Deterministic adopt first; this skill classifies leftover notes and proposes zone cards without stamping.
Use when navigating a repo's code or its Atlas — locating a definition/usage/file, tracing an import, or finding which zone/decision/spec explains something. Reach here before reflexive grep+Read.
Use when an Atlas vault is empty or near-empty (0–2 zones after atlas init) — bootstrap 4–8 seeded zone cards from a real codebase analysis. Also use for "seed the mind", "initial zones", "first map pass", "bootstrap atlas", or atlas-fleet seed-empty.
Use when the user wants to update atlas, an atlas update is available, doctor or status reports a version nudge / pending migrations, or they ask to bring the vault to latest. Deterministic migrate first; this skill handles AI-merge of locally edited vendored files.
Use when authoring or editing an Atlas note (zone, decision, spec, plan, idea, debt, pillar) — the summary and section structure determine what a retrieval engine surfaces later.
| name | atlas-recollection |
| description | Use when finishing a change in a repo that has an Atlas — before ending the session or opening a PR, to keep the vault's zone cards, stamps, and ledger entries in sync with the code just changed. |
Recollection happens as part of finishing the change, not as a separate pass. Run this checklist before ending the session:
Update touched zone cards. Any zone card (map/zones/<slug>.md)
whose owns/depends/invariants claims changed because of this change
— edit it now, not later.
Re-stamp exactly the zones you reviewed. atlas stamp <slug...> —
name only the zones whose owned code you actually changed and re-read
against the card. Never a blanket re-stamp; there is no "all zones"
shortcut, by design. Order matters: commit the code + card edits first,
then stamp — verifiedAt anchors to the committed HEAD, so stamping
before the commit leaves the zone stale.
Decision record for any non-obvious why. If the change involved a
choice a future reader would ask "why did we do it this way," add a
map/decisions/NNNN-slug.md. Obvious mechanical changes don't need one.
Tech-debt note for every deferral. Anything deliberately left
undone gets a tech-debt/ note (type: debt, severity, effort) — not
a TODO comment, not a mention in a commit message only.
Rebuild and check. atlas check — regenerates map/index.md and
verifies zone claims and the ledger (add --strict in CI to also fail on
staleness). Commit the regenerated index together with the code change, in
the same commit — never as a separate follow-up.
Supersede, don't edit; tombstone, don't delete. Past-tense notes
(specs, decisions, done plans) are read-only once frozen — write a
superseding note instead of editing history. A retired zone/flow/decision
gets status: unmounted, never file deletion.
work-kb (parent / multi-repo work vault). After the mind steps above, call the shared finish hook once — same script coding-ops uses on DONE. This is not a second recollect; it only logs fleet work.
bash ~/Repositories/hermes/coding-ops/post-session-recollect.sh \
--source cli \
--summary "<one line what finished>"
# optional: --slug my-feature --related "other-repo"
# infers repo/worktree/slug from cwd when possible
If the script is missing, skip. Do not invent a separate work-kb ceremony.
seeded zone card only flips to status: active via a
human-or-reviewed verification pass — an agent generating or regenerating
a card must never self-promote it.