Capture session learnings into brain-os convention docs with provenance citations. Use when you notice a non-obvious insight worth preserving.
Capture learnings from the current session into brain-os convention docs. You have full conversational context — use it to produce high-quality entries with inline footnote citations.
IMPORTANT: Do NOT call claude -p. You are doing this inline.
Identify insights worth capturing from the current conversation. Look for:
Find your session JSONL for citation line numbers:
/ with -.jsonl in ~/.claude/projects/<encoded-cwd>//.claude/worktrees/<name> from CWD and retryWrite to the appropriate brain-os convention doc at :
~/workspace/personal/explorations/brain-os/rust/rust-conventions.md, unix/xdg-conventions.md)## section, or create a new sectionAdd footnote citations using per-doc append-only numbering:
max(existing footnote numbers) in the target doc, use max + 1[^N] at the end of the insight text[^N]: session:<prefix>:<line> "<description>"<prefix> = first 8 chars of session UUID (from JSONL filename)<line> = JSONL line number of the source entry/doctor can validate laterCreate a PR via Graphite:
cd ~/workspace/personal/explorations/brain-os
git add <modified files>
gt create -m "knowledge: <brief description>"
gt submit --no-interactive --publish
Report what was captured and where, with the PR link.
"Is this true and useful to future-me?" — a one-sentence gotcha is just as valuable as a multi-paragraph pattern. Don't pad entries for length.