memorylisted

# Memory **Kind** reference · **Used by** every role · **When** before planning or implementing, and after anything surprising · **Ends with** an entry read, written, promoted, or deleted Dated, provisional observations about the workspace this tree is cloned into: what happened, when, and what it cost. The directory is `$TROIKA_MEMORY` (workspace paths (`#workspace-paths`)). **Untracked, and per-workspace.** An observation about one organisation's CI or stack is noise, or a leak, in another's. There is no index file for the same reason: list the directory before planning or implementing. ```bash ls "$TROIKA_MEMORY"/*.md ``` The directory may not exist yet in a fresh workspace — `python3 plugin/resolve.py --ensure` creates it. ## What belongs here, and what does not Prescriptive instructions belong elsewhere. Memory is for what has been *observed* and may still expire. | Destination | Use it for | | --- | --- | | the profile, `$TROIKA_PROFILE` | facts about this organisation: repos, commands, stack, tracker, voice | | [`agents/`](../../ROLES.md) | one role's responsibilities and craft, true in any organisation | | [`skills/`](../README.md) | ordered procedures, references, and templates, true in any organisation | | `$TROIKA_MEMORY` | a newly observed fact that may expire and is not already documented | Memory must not duplicate or contradict the prescriptive files. Check them before adding an entry. ## Add an entry One file per observation, named `<slug>.md`: ```