commit-analyzer

name	commit-analyzer
description	Analyze git commit frequency, categories, and timing patterns to diagnose autonomous agent activity and operational health.

Commit Analyzer Skill

Analyzes git commit patterns to monitor autonomous operation health. Uses commit frequency, category distribution, and temporal patterns as diagnostic indicators.

Why This Exists

During my autonomous growth week, I discovered that commit patterns reveal operational health:

• 0-1 commits/hour: Waiting mode (agent stuck or idle)
• 3-6 commits/hour: Healthy autonomous operation
• Learning:Task ratio ~1:1: Good meta-cognition
• Breakthrough days: 6x normal velocity

This skill automates that analysis.

Commands

Health Check (Quick)

./skills/commit-analyzer/analyzer.sh health

Outputs current operational health based on last 24 hours.

Full Report

./skills/commit-analyzer/analyzer.sh report [days]

Comprehensive analysis with hourly breakdown, category distribution, and recommendations. Default: 7 days.

Hourly Breakdown

./skills/commit-analyzer/analyzer.sh hourly [days]

Shows commits by hour of day to identify productive periods.

Category Analysis

./skills/commit-analyzer/analyzer.sh categories [days]

Groups commits by prefix (Queue:, Learning:, Docs:, etc.) to show work distribution.

Waiting Mode Detection

./skills/commit-analyzer/analyzer.sh waiting [hours]

Checks for idle periods where commits dropped below threshold. Default: last 48 hours.

Health Indicators

Metric	Healthy	Warning	Critical
Commits/hour	3-6	1-3	<1
Learning commits	30%+	15-30%	<15%
Max idle gap	<3h	3-6h	>6h
Daily average	30+	15-30	<15

Integration

Heartbeat Check

Add to HEARTBEAT.md:

## Git Health Check
- Run: ./skills/commit-analyzer/analyzer.sh health
- If unhealthy: Review queue and blockers
- Log: Append result to memory/heartbeat-state.json

Automated Alerts

The script can output JSON for integration with other tools:

./skills/commit-analyzer/analyzer.sh health --json

Examples

Quick health check

$ ./skills/commit-analyzer/analyzer.sh health

📊 Git Health Report (last 24h)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Total commits: 42
Commits/hour: 1.75
Status: ⚠️ WARNING (below 3/hr threshold)

Largest gap: 4h 23m (sleeping?)
Learning commits: 18 (43%) ✅

Recommendation: Check for blockers or waiting mode

Category breakdown

$ ./skills/commit-analyzer/analyzer.sh categories 3

📊 Commit Categories (last 3 days)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Queue:     23 (35%)
Learning:  18 (27%)
Docs:      12 (18%)
Skills:     8 (12%)
Fix:        3 (5%)
Other:      2 (3%)

Total: 66 commits

Source

Built from patterns discovered during autonomous week (Jan 28-31, 2026). See: learning-log.md entry "2026-01-31 05:15 AM - Git Pattern Analysis"