# Retrospective Report — {TIMEFRAME}

**Period:** {SINCE} → {UNTIL}
**Generated:** {TODAY}
**Repo:** {REPO_NAME}
**Authors:** {AUTHOR_COUNT} active

---

## Velocity

| Metric | Value | {COMPARE_COL} |
|--------|-------|---------------|
| Total commits | {TOTAL_COMMITS} | {DELTA_COMMITS} |
| Commits / day | {COMMITS_PER_DAY} | {DELTA_COMMITS_DAY} |
| Active days | {ACTIVE_DAYS} / {PERIOD_DAYS} ({ACTIVE_PCT}%) | {DELTA_ACTIVE} |
| Files changed | {FILES_CHANGED} | {DELTA_FILES} |

*Remove delta column if `--compare` not set.*

---

## Code Health

| Metric | Value | {COMPARE_COL} |
|--------|-------|---------------|
| LOC added | {LOC_ADDED} | {DELTA_LOC_ADDED} |
| LOC removed | {LOC_REMOVED} | {DELTA_LOC_REMOVED} |
| Net LOC | {LOC_NET} | {DELTA_LOC_NET} |
| Churn rate | {CHURN_RATE}x | {DELTA_CHURN} |
| Test-to-code ratio | {TEST_RATIO}% | {DELTA_TEST_RATIO} |

*Remove delta column if `--compare` not set.*

---

## Commit Distribution

```
{COMMIT_TYPE_BAR_OR_TABLE}
```

Example format:
```
feat     ████████████ 12 (40%)
fix      ████████     8  (27%)
chore    ████         4  (13%)
refactor ███          3  (10%)
test     ██           2  (7%)
docs     █            1  (3%)
```

---

## File Hotspots

Top files by change frequency:

| Rank | File | Changes |
|------|------|---------|
| 1 | {FILE_1} | {COUNT_1} |
| 2 | {FILE_2} | {COUNT_2} |
| 3 | {FILE_3} | {COUNT_3} |
| ... | ... | ... |

---

## Plan Progress

| Metric | Value |
|--------|-------|
| Completed tasks | {TASKS_DONE} |
| Open tasks | {TASKS_OPEN} |
| Completion rate | {PLAN_PCT}% |
| Issues closed (period) | {ISSUES_CLOSED} |

---

## Team Breakdown

*Include only when `--team` flag is set. Otherwise omit this section.*

| Author | Commits | LOC Net | Types |
|--------|---------|---------|-------|
| {AUTHOR_1} | {COMMITS_1} | {LOC_1} | {TYPES_1} |
| {AUTHOR_2} | {COMMITS_2} | {LOC_2} | {TYPES_2} |

---

## Highlights

- [OK] {POSITIVE_FINDING_1}
- [OK] {POSITIVE_FINDING_2}
- [!] {NOTABLE_FINDING}

*Replace with 2-4 factual observations from the data. No invented praise.*

---

## Recommendations

1. **{ACTION_1}** — {RATIONALE_1} (based on {METRIC})
2. **{ACTION_2}** — {RATIONALE_2} (based on {METRIC})
3. **{ACTION_3}** — {RATIONALE_3} (based on {METRIC})

*3-5 specific, actionable items grounded in the metrics above. No generic advice.*

---

*Generated by `mk:retro` — data sourced from git history only*
