roll-brieflisted

# Roll Brief > Follows the Architecture Constraints, Development Discipline, and Engineering > Common Sense defined in the project AGENTS.md. Owner-facing digest of autonomous agent activity. Gives the human everything needed to decide whether to cut a new release — without having to read every commit or diff. ## Distinct from roll-.changelog | | roll-brief | roll-.changelog | |--|-----------|----------------| | **Audience** | Product owner (internal) | End users (public) | | **Content** | All activity including REFACTOR, escalations, health signals | Only user-visible feature changes | | **Trigger** | Feature completion / daily / on-demand | Post-deploy | | **Tone** | Operational, candid | Product-facing, polished | ## Trigger Modes ### 1. Feature Completion (auto) Triggered by `roll-loop` when a set of related Stories under one Feature are all marked ✅ Done. The loop passes the Feature name as context. ### 2. Daily Morning (scheduled) Runs at a fixed time each morning (configurable in `~/.roll/config.yaml`). Covers all activity since the previous brief. ```yaml # ~/.roll/config.yaml brief: daily_time: "08:00" # local time timezone: "Asia/Shanghai" ``` ### 3. On-Demand ```bash $roll-brief # since last brief $roll-brief --since 2026-05-09 # since specific date $roll-brief --feature auth # scoped to one feature ``` ## Workflow ### Step 1 — Determine Scope ```bash # Find timestamp of last brief ls .roll/briefs/ | sort | tail -1 # Rea