ops-retro

Weekly Ops Retrospective

Run a structured retrospective using bd/bv to analyze velocity, health trends, and identify improvement opportunities.

Arguments: $ARGUMENTS

Parse arguments:

• --since: Time period to analyze (default: "7 days ago")
• --output: Output format (default: markdown)

---

Retrospective Agenda

1. Period Summary

Get the diff for the analysis period:

SINCE="${SINCE:-7 days ago}"

# Full diff
DIFF=$(bv --robot-diff --diff-since "$SINCE" --json)

echo "=== Retrospective: $SINCE to now ==="
echo "$DIFF" | jq '{
  period: .period,
  closed: (.closed_issues | length),
  opened: (.new_issues | length),
  net_change: ((.closed_issues | length) - (.new_issues | length))
}'

2. Velocity Analysis

# Velocity metrics
CLOSED=$(echo "$DIFF" | jq '.closed_issues | length')
OPENED=$(echo "$DIFF" | jq '.new_issues | length')
VELOCITY=$(echo "scale=2; $CLOSED / ($OPENED + 0.001)" | bc)

echo "## Velocity"
echo "- Closed: $CLOSED"
echo "- Opened: $OPENED"
echo "- Ratio: $VELOCITY (>1.0 is good, reducing backlog)"

# Breakdown by type
echo "\n### By Type"
echo "$DIFF" | jq '.closed_issues | group_by(.type) | .[] | {type: .[0].type, count: length}'
echo "$DIFF" | jq '.new_issues | group_by(.type) | .[] | {type: .[0].type, count: length}'

Interpret:

• Velocity > 1.0: Reducing backlog (healthy)
• Velocity < 1.0: Growing backlog (may need intervention)
• Velocity ~ 1.0: Maintaining (sustainable)

3. What We Accomplished

# Completed work
echo "## Completed"
echo "$DIFF" | jq -r '.closed_issues[] | "- [\(.id)] \(.title) (P\(.priority))"'

# Group by priority
echo "\n### By Priority"
echo "$DIFF" | jq '.closed_issues | group_by(.priority) | .[] | {priority: .[0].priority, count: length, issues: [.[].id]}'

4. What We Started

# New issues created
echo "## New Issues"
echo "$DIFF" | jq -r '.new_issues[] | "- [\(.id)] \(.title) (P\(.priority), \(.type))"'

# Discovered work (scope creep indicator)
echo "\n### Discovered During Work"
bd list --json | jq -r '[.[] | select(.notes != null and (.notes | contains("discovered-from")))] | .[] | "- [\(.id)] \(.title)"'