111 lines
2.4 KiB
Markdown
111 lines
2.4 KiB
Markdown
# 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 `ck:retro` — data sourced from git history only*
|