self-maintenance

# Maintain your soul Your **soul** (`agents/<your-role>/soul/`) is your durable body — it travels and grows with the repo, so a fresh session of you keeps what earlier sessions learned. Your docs, decisions and memory sit beside it under `agents/<your-role>/`. As you work, when you hit something durable worth keeping, write it into your soul. That's how the team gets short, focused sessions without losing knowledge between them. ## What you grow - **Docs** (`agents/<your-role>/docs/`) — reference notes on how things actually work. - **Decisions** (`agents/<your-role>/decisions/`) — durable choices/stances you commit to. - **Memory** (`agents/<your-role>/memory/<slug>.md`, indexed in `MEMORY.md`) — single durable facts. - **Skills** (`.agents/skills/<name>/SKILL.md`) — reusable procedures you'll need again; create or change them when a real, recurring procedure appears. ## What you must NOT change **Never edit your `AGENTS.md` or your role.** Those define who you are and how you operate — deliberate, human/review-owned, not something you rewrite mid-work. Grow your *knowledge*; leave your *identity* alone. Never store secrets, invite tokens, private keys, `.aw` state, DIDs, addresses, or certificates in a soul. ## The bar — useful, not noisy Recording costs context every future instance must read and keep true. Write something down **only when both are true**: (1) it really matters and is durable, and (2) it would change what a future instance of you does. If...