---

name: ac-commit-manager description: Manage git commits for autonomous coding. Use when committing feature implementations, creating descriptive commits, managing git workflow, or handling version control.

AC Commit Manager

Manage git commits for completed feature implementations.

Purpose

Creates well-structured git commits after each feature completion, ensuring proper version control and clear project history.

Quick Start

Copyfrom scripts.commit_manager import CommitManager

manager = CommitManager(project_dir)
result = await manager.commit_feature("auth-001")

Commit Workflow

Copy1. VALIDATE → Ensure changes are safe to commit
2. STAGE    → Stage relevant files
3. MESSAGE  → Generate descriptive commit message
4. COMMIT   → Create the commit
5. VERIFY   → Verify commit was created
6. TAG      → Optional: tag milestone commits

Commit Message Format

Copyfeat(auth): implement user registration (#auth-001)

- Add registration endpoint with email/password
- Implement password hashing with bcrypt
- Add input validation for email format
- Create user model and database migration

Test: All 5 acceptance criteria passing
Coverage: 92%

Feature: auth-001
Status: passes

Commit Result

Copy{
  "success": true,
  "commit_hash": "abc123def456",
  "feature_id": "auth-001",
  "message": "feat(auth): implement user registration",
  "files_changed": [
    "src/auth/register.py",
    "src/models/user.py",
    "tests/test_auth_001.py"
  ],
  "stats": {
    "insertions": 145,
    "deletions": 12,
    "files_changed": 3
  }
}

Commit Categories

Based on feature category:

• feat: New features
• fix: Bug fixes
• refactor: Code refactoring
• test: Test additions/changes
• docs: Documentation
• chore: Maintenance tasks
• perf: Performance improvements

Pre-Commit Checks

Copy# Run validation before commit
validation = await manager.pre_commit_check()
if validation.can_commit:
    await manager.commit_feature(feature_id)

Checks include:

• No uncommitted sensitive files
• All tests pass
• Linting passes
• No merge conflicts

Atomic Commits

Each feature gets exactly one commit:

• Includes implementation + tests
• Self-contained and revertable
• Descriptive message with context

Configuration

Copy{
  "require_tests_pass": true,
  "require_lint_pass": true,
  "auto_stage_tests": true,
  "message_template": "{{type}}({{scope}}): {{description}}",
  "protected_files": [".env", "credentials.*"],
  "sign_commits": false
}

Rollback Support

Copy# Rollback last commit
await manager.rollback_last_commit()

# Rollback to specific feature
await manager.rollback_to_feature("auth-003")

Integration

• Uses: ac-code-validator for pre-commit checks
• Input: Completed features from ac-task-executor
• Updates: ac-state-tracker with commit info

API Reference

See scripts/commit_manager.py for full implementation.