proactive-brieflisted

# Proactive Brief Generate concise, actionable status briefs from project state and recent activity — inspired by Claude Code's KAIROS Brief Mode. ## Concept A brief is not a summary. It's a **delta report**: only what changed, only what matters, only what needs action. If someone read the last brief, this one should tell them everything new in 15 seconds. ## Design Principles 1. **Brief, not verbose** — max 20 words per item. If it needs more, link to a file. 2. **Delta-based** — only what CHANGED since last brief. No restating known facts. 3. **Actionable** — every item is either informational ("X happened") or actionable ("Y needs attention by [when]") 4. **15-second rule** — the whole brief should be scannable in 15 seconds. If it's longer, it's not brief. 5. **Source-linked** — every claim cites its source (commit, PR, issue, conversation) ## Brief Template ```markdown # Brief — [Date] ## Needs Attention - [Thing]: [1-line what + why] → [suggested action] (source: [ref]) ## Changed - [Topic]: [what changed] (source: [ref]) ## Upcoming (next 48h) - [Deadline/event]: [1-line context] ## Learned (new durable facts) - [Fact]: [value] (source: [ref]) ``` **That's it.** Four sections. If a section is empty, omit it. ## Sources What you pull from depends on your project setup. Check what's available: ### Tier 1: Always available (any project) ```bash # Recent commits git log --since="24 hours ago" --oneline --no-merges # Changed files git diff --stat HEAD~5 # O