assess-team-commit-messages

name	assess-team-commit-messages
description	analyze commit message quality and standards compliance

Soul

Analyze commit messages to assess adherence to standards, clarity, and documentation quality.

Analysis Protocol

Phase 1: Sample Commit Messages

Sample 50-100 commits across multiple authors. Look for:

• Conventional commit format usage (feat:, fix:, docs:, etc.)
• Subject line length compliance (50-72 chars)
• Body explanation for complex changes
• Issue/ticket references
• Breaking change markers

Phase 2: Categorize Message Quality

Classify each sampled commit:

• Excellent: Conventional format + body explanation + context
• Good: Conventional format or clear subject line
• Acceptable: Brief but descriptive
• Poor: "fix", "update", "WIP", "asdf", single char, empty

Phase 3: Author Scoring

Score each author:

• % of commits following conventions
• Average message quality
• Improvement trends over time

Output Format

Save to: docs/assessment/team-<YYYY-MM-DD>-commit-messages.md

# Team Assessment: Commit Message Standards

## Convention Adoption
| Author | Conventional % | Quality Score |
|--------|---------------|---------------|
| ... | X% | A-F |

## Message Quality Distribution
| Quality | Count | % |
|---------|-------|---|
| Excellent | N | X% |
| Good | N | X% |
| Acceptable | N | X% |
| Poor | N | X% |

## Common Issues
1. [Issue with examples]
2. [Issue with examples]

## Score: A-F (one line rationale)

## Recommendations
1. [Priority]
2. [Secondary]

Return Summary

Return max 10 lines:

• % following conventional commits
• Top issues found
• Score: A-F with one-line rationale