| name | retrospective |
| description | Generates evidence-based sprint retrospectives by mining git history, GitHub PRs, and decision logs into objective metrics. Use when the user asks for a sprint retrospective, wants to analyze team or agent collaboration over a period, needs rework/testing discipline metrics, or runs the `agentic-retrospective` CLI. |
Retrospective
Evidence-based sprint retrospectives. Produces objective metrics from git history, GitHub PRs, and decision logs. No AI slop - every finding links to specific commits, PRs, or decisions.
What This Tool Provides
| Metric | Source | Example Output |
|---|
| Commit Type Breakdown | git log | "59.7% fixes, 10.8% features, 1.6% tests" |
| PR Supersession Rate | GitHub | "15/20 PRs superseded (75% rework)" |
| Testing Discipline | Decision logs | "2% of decisions mention testing" |
| Decision Quality Score | Decision logs | "78% have both rationale AND context" |
| Agent Commit Detection | git log | "45 commits (11.8%) by agents" |
| Rework Chains | git log | "3 fix commits following feature X" |
| Security Vulnerabilities | Scan outputs | "5 critical, 12 high severity" |
Sub-commands
/retrospective
Conduct full retrospective analysis.
npx agentic-retrospective
npx agentic-retrospective --from HEAD~50
npx agentic-retrospective --from "2 weeks ago"
/retrospective feedback
Provide session feedback (30 seconds).
npx agentic-retrospective feedback
/retrospective setup
Initialize telemetry directories.
mkdir -p .logs/decisions .logs/prompts .logs/tools .logs/feedback .logs/security
/retrospective status
Check telemetry setup and data availability.
ls -la .logs/
Output Sections
- Executive Summary - 10+ metrics in table format
- Commit Type Breakdown - feat/fix/docs/test/refactor/chore
- PR Analysis - supersession rate, test coverage, reviews
- What Worked / What Didn't - threshold-based assessment
- Testing Discipline - % decisions mentioning tests
- Mistakes & Corrections - documented learnings
- Recommendations - current state, target, action
Requirements
- Required: git
- Optional: gh CLI (for PR analysis), decision logs, security scans
