git-commit-template

# Git Commit Template

Create structured, changelog-style Git commit messages using five standard categories. This ensures consistent, searchable, and maintainable commit history across projects.

## Commit Structure

All commits follow this format:

```
[Type] Short descriptive title (under 72 chars)

Optional body with detailed explanation, implementation notes,
breaking changes, or migration instructions.
```

## Commit Types

### Added
For new features, functionality, or capabilities.

```bash
git commit -m "[Added] user authentication with JWT" -m "Implemented JWT-based auth with login/logout endpoints and token refresh"
```

### Changed
For changes in existing functionality, refactoring, or improvements.

```bash
git commit -m "[Changed] improved database query performance" -m "Added composite indexes, reduced query time from 250ms to 15ms"
```

### Deprecated
For features that will be removed in future releases.

```bash
git commit -m "[Deprecated] legacy API v1 endpoints" -m "Will be removed in v3.0. Migration guide: docs/migration.md"
```

### Removed
For removed features, code, or dependencies.

```bash
git commit -m "[Removed] support for Python 3.7" -m "Minimum version now 3.8. Updated CI/CD and docs."
```

### Fixed
For bug fixes and error corrections.

```bash
git commit -m "[Fixed] memory leak in WebSocket handler" -m "Fixed unclosed connections causing unbounded memory growth. Closes #1234"
```

## Quick Start

### Method 1: Interactive Helper Script (Recommended)

Use the bundled Python script for guided commit creation:

```bash
python scripts/commit.py
```

The script will:
1. Show staged files
2. Prompt for commit type selection
3. Ask for title and optional body
4. Preview and confirm before committing

### Method 2: Direct Command Line

For quick commits:

```bash
# Title only
python scripts/commit.py Added "user profile page"

# Title with body
python scripts/commit.py Fixed "login timeout" "Increased session timeout from 5 to 15 minutes"
```...