commit

# Commit

## Purpose

Create standardized git commits following Conventional Commits specification. Analyzes changes to determine appropriate type, scope, and message.

## Quick Reference

- **Setup**: `/commit configure` (run once per project)
- **Usage**: `/commit` (uses saved scopes)
- **Update**: `/commit learn` (re-analyze scopes from recent commits)
- **Config**: Depends on installation model (see Save Location)

## Commands

| Command | Purpose | When to Use |
|---------|---------|-------------|
| `/commit configure` | Analyze project for commit scopes | First time in a project |
| `/commit learn` | Update scopes from recent commits | After project changes |
| `/commit` | Create commit using saved scopes | Normal usage |

---

## /commit configure

**When**: First time using `/commit` in a project

**What it does**:
1. Scans project structure for scope candidates
2. Analyzes recent commit history for patterns
3. Proposes scope configuration to user
4. Saves config based on plugin installation scope

### Discovery Process

```
1. SCAN PROJECT STRUCTURE
   ├─ Top-level src/ directories
   ├─ Workspace packages (package.json workspaces)
   ├─ Go modules (go.work)
   └─ Python packages (pyproject.toml)

2. ANALYZE COMMIT HISTORY
   ├─ Extract scopes from last 100 commits
   ├─ Count frequency of each scope
   └─ Identify naming patterns

3. PROPOSE TO USER
   └─ Show discovered scopes, wait for approval
```

### Proposal Format

```yaml
# Proposed Commit Configuration
# Review and approve to save to .claude/skills/commit.yaml

scopes:
  - name: api
    description: "REST API endpoints"
    paths: ["src/api/", "api/"]
  - name: auth
    description: "Authentication and authorization"
    paths: ["src/auth/", "src/middleware/auth"]
  - name: db
    description: "Database and migrations"
    paths: ["src/db/", "migrations/"]
  - name: ui
    description: "User interface components"
    paths: ["src/components/", "src/pages/"]
  - name: core
    description: "Core bu