progress-update

Generate Sprint Progress Update

Usage: /progress-update or /progress-update <sprint-date>

Purpose: Generate comprehensive progress update for active sprint

---

📊 Progress Update Generation

Step 1: Identify Active Sprint

Find the most recent sprint tracking document:

# Find latest sprint progress file
ls -t docs-internal/SPRINT_PROGRESS_*.md | head -1

# Or use provided date
SPRINT_FILE=docs-internal/SPRINT_PROGRESS_$ARGUMENTS.md

If no sprint file found:

• Check if sprint was started with /start-sprint
• Look for sprint plan: docs-internal/SPRINT_PLAN_*.md
• Ask user which sprint to update

---

Step 2: Collect Sprint Metrics

Gather current metrics from repository:

Code Metrics:

# Recent commits since sprint start
git log --oneline --since="$(date -d 'sprint start date' +%Y-%m-%d)" | wc -l

# Files modified
git diff --name-only <sprint-start-commit>..HEAD | wc -l

# Lines changed
git diff --stat <sprint-start-commit>..HEAD

Test Metrics:

# Run tests and capture results
pytest --collect-only -q | tail -1  # Total test count

# Run tests with verbose output
pytest -v --tb=short 2>&1 | tee /tmp/test_results.txt

# Parse results
grep -E "(passed|failed|skipped)" /tmp/test_results.txt | tail -1

Coverage Metrics:

# Generate coverage report
pytest --cov=src --cov-report=term-missing 2>&1 | grep "TOTAL"

TODO Status:

# Count remaining TODOs in source code
grep -r "TODO" src/ | wc -l

# Compare with catalog
cat docs-internal/TODO_CATALOG.md | grep -E "^(###|####)" | wc -l

---

Step 3: Analyze TodoWrite Status

Check current todo list status:

From TodoWrite tool:

• Total items created
• Completed count
• In progress count
• Blocked count
• Pending count

Calculate:

• Completion rate: (completed / total) * 100%
• Velocity: completed items / days elapsed

---

Step 4: Check Git Activity

Review git activity since sprint start:

# Commits per day
git log --since="sprint start" --pretty=format:"%ad" --date=short | sort | uniq -c

# Commit types (feat, fix, docs, test, refactor)
git log --oneline --since="sprint start" | grep -oE "^[a-z0-9]+ (feat|fix|docs|test|refactor|chore)" | cut -d' ' -f2 | sort | uniq -c

# Files most modified
git log --since="sprint start" --name-only --pretty=format: | sort | uniq -c | sort -rn | head -10