van7171 Conversation Notes
When asked to make a note or record learnings:
- Infer a descriptive topic slug from the conversation (kebab-case, as many words as needed to be clear)
- Target file:
docs/notes/<topic-slug>.mdrelative to the workspace root - Create
docs/notes/if it does not exist - Write the note:
# <Descriptive Title That Fully Captures the Topic>
## What We Learned
<Full prose or detailed bullets covering everything discovered: behavior, flow control,
callers, edge cases, decisions made, and why. Do not summarize — explain thoroughly.>
## Context
<What prompted the investigation or conversation.>
Write to inform someone who wasn't in the conversation. Include detail on flow control, callers, data shapes, failure modes, or anything else relevant. For code references, cite file/path.ext:LineN or method/class names inline.