After a meaningful conversation — decisions made, patterns discovered, preferences stated — the user may ask you to capture what was discussed into the project's CLAUDE.md. This ensures future sessions benefit from today's context.

Which CLAUDE.md?

Find the CLAUDE.md you own in the current repo:

In ~/clawd/ — update your agent file (e.g. yuki/CLAUDE.md, kestrel/CLAUDE.md)
In any other repo — update the project root CLAUDE.md

If unsure, ask which file to update.

How to Update

Review the conversation — identify decisions, preferences, patterns, or conventions that were established
Read the current CLAUDE.md — understand what's already documented
Add only what's new — don't duplicate existing content
Place it in the right section — match the file's existing structure. Create a new section only if nothing fits.
Be concise — write it as an instruction, not a narrative. Future agents need to act on it, not read a story.

What to Capture

Workflow decisions ("always use X instead of Y")
Tool preferences ("use og pr, not gh")
Conventions discovered ("tests go in tests/ not test/")
Architecture decisions ("we chose X because Y")
Gotchas and warnings ("don't run Z, it breaks W")

What NOT to Capture

Session-specific details (current task, in-progress work)
Anything already in CLAUDE.md (check first!)
Speculative conclusions from one conversation
Temporary workarounds (unless they'll persist)

After Updating

Show the user what you added/changed
Commit if asked (follow the repo's commit conventions)