Example Brainstorm¶
Brainstorms capture exploratory discussions, architectural decisions, and design trade-offs for future reference. They document thinking — not work progress. Each brainstorm serves as a decision record: options considered, trade-offs, and rationale. Ask Lore to create one — for example: "Start a brainstorm about auth options." Lore handles the folder structure and frontmatter.
Template¶
File: docs/work/brainstorms/<slug>/index.md
---
title: <Topic>
created: 2026-01-10
---
# <Topic>
## Context
<What prompted this discussion. Key questions to answer.>
## Approaches Considered
### Option 1: <Name>
**Approach:** <How it works.>
**Pros:**
- <Advantage>
- <Advantage>
**Cons:**
- <Disadvantage>
- <Disadvantage>
**Effort:** <Estimate>
---
### Option 2: <Name>
**Approach:** <How it works.>
**Pros:**
- <Advantage>
- <Advantage>
**Cons:**
- <Disadvantage>
- <Disadvantage>
**Effort:** <Estimate>
## Recommended Approach
**Selected:** <Option name>
**Rationale:**
- <Why this option>
- <Key factors>
## Decision
<Clear statement of what was decided and first steps.>
## Follow-Up
This brainstorm informed:
- [<Roadmap or Plan Name>](../path/to/index.md)