Weekly Digests
Weekly digests are LLM-generated summaries of your team's activity over a one-week period. They combine quantitative metrics with natural language narrative to give managers a quick pulse check.
Overview
Each digest covers a Monday–Sunday window and can be generated at two scopes:
| Scope | Coverage |
|---|---|
| Company-wide | All contributors across all teams |
| Per-team | Contributors within a specific team |
Digests are generated by Claude Sonnet, using commit data, scores, and work patterns as input. Typical cost: $0.003–0.01 per digest.
Content Sections
1. Tweetable Summary
A single-line summary of the week, designed to be skimmable:
"15 contributors shipped 142 commits across 6 projects — velocity up 12% from last week."
2. Activity Overview
Commits broken down by project and type:
- Commits per project
- Commit type distribution (feat, fix, refactor, etc.)
- Comparison to previous week
3. Contributor Breakdown
Per-contributor summary:
| Field | Description |
|---|---|
| Name | Contributor name |
| Commits | Count for the week |
| Average score | Mean commit score |
| Projects | Which projects they worked in |
4. Work Patterns
Team-level work pattern analysis:
- Team streak — Consecutive days where at least one team member shipped
- Sessions — Aggregate deep/medium/micro session counts, average duration
- Focus areas — Per-contributor top areas and focus percentages
- Commit sizes — S/M/L/XL distribution and complexity smells
- Per-contributor breakdown — Individual work pattern highlights
5. Commit Type Breakdown
Aggregate type frequencies across the team, with automatic warnings:
Fix Ratio Warning
If more than 50% of commits are fixes, the digest flags this prominently. A high fix ratio sustained over multiple weeks may indicate quality issues, inadequate testing, or unstable releases.
6. Risk Signals
Two categories of risk are surfaced:
- Gaming flags — Any commits flagged by the gaming detector, with details
- Low-score commits — Commits scoring below 4.0, listed for review
7. Previous Week Comparison
A snippet from the prior week's digest is included for context, enabling trend awareness without switching between reports.
Generation Process
Status States
| Status | Meaning |
|---|---|
pending | Digest scheduled but not yet generated |
generating | LLM is currently producing the content |
completed | Digest ready for viewing |
failed | Generation failed (LLM error, timeout, etc.) |
Cost
| Component | Typical Cost |
|---|---|
| Input tokens | ~2,000–5,000 tokens |
| Output tokens | ~1,000–2,000 tokens |
| Total per digest | $0.003–0.01 |
For a company with 5 teams generating weekly digests: ~$0.25–0.50/month.