brain-reflect

Synthesize patterns across recent sessions into a weekly insight note. Run at end of week or whenever you want a retrospective.

Steps

1. Load config and locate session notes

cat ~/.claude/brain/config.json

Get vault_path. List available session notes:

ls VAULT_PATH/_sessions/ | sort

2. Determine scope

Ask the user:

"How many days back should I look? Default is 7 (last week). Enter a number or press Enter."

If Enter or "default", use 7. Call this DAYS.

Calculate date range: today minus DAYS through today.

3. Read session notes in range

For each date in range that has a file in _sessions/, read the full file.

Also read VAULT_PATH/Polaris/top-of-mind.md if it exists.

4. Synthesize patterns

Using your own reasoning across session content, produce a reflection covering:

Theme distribution — which primary themes appeared and how often (building / debugging / researching / planning / configuring)

Wins — concrete things that got done (from outcome=done sessions, knowledge items with destination=project)

Recurring blockers — anything that appeared more than once as a blocker

Durable learnings — the most reusable insights across the week (look at personal atoms created)

Alignment signal — overall trend; any drift from Polaris top-of-mind?

Suggested Polaris updates — based on what you actually worked on vs what top-of-mind.md says, suggest specific edits

Thread worth picking up — the most interesting unexplored area from the week

Next week focus — concrete recommendation for what to prioritize

5. Write weekly note

python3 -c "from datetime import date; d=date.today(); print(f'{d.year}-W{d.isocalendar()[1]:02d}')"

Write to VAULT_PATH/weekly/YYYY-Www.md. If file already exists, prepend a new section (same-week re-runs accumulate, don't replace).

Format:

# Week YYYY-Www Reflection
_<start_date> – <end_date> · <N> sessions · <N> days_

## Theme distribution
<theme>: N · <theme>: N · ...

## Wins
- ...

## Recurring blockers
- ...

## Durable learnings
- ...

## Alignment: <high|medium|low|mixed>
<1-2 sentences on alignment trend>

## Suggested Polaris updates
- [ ] <specific suggested edit to top-of-mind.md>
- [ ] ...

## Thread worth picking up
<the most interesting unexplored thread>

## Next week focus
<concrete recommendation>

---
_Generated by /brain-reflect on <today>_