lore-framework-git

# Git Commits with Lore Integration

Create semantic, version-aware commit messages following Conventional Commits 1.0.0 with lore task traceability.

## Quick Reference

**Format:**
```
<type>(<lore-NNNN>): <description>

[optional body]

[optional footer(s)]
```

**Example:**
```
feat(lore-0042): add OAuth2 login flow

Support Google and GitHub OAuth providers.
Tokens are stored securely in session storage.
```

## Lore Task Reference

**Always include task reference when working on a lore task.**

### In Scope (Required)

```
feat(lore-0008): implement PostgreSQL schema
fix(lore-0012): correct prompt template escaping
refactor(lore-0017): restructure directory layout
```

**Format:** `(lore-NNNN)` where NNNN is the task ID from `lore/1-tasks/`

**Why task references matter:**
- `git blame` → commit → task → full context
- Future sessions can trace code back to decisions
- Worklogs explain WHY code exists
- Enables "archaeology" of codebase history

### Finding Current Task

Check `lore/0-session/current-task.md` symlink to see active task, or use `lore-framework_show-session` MCP tool.

## Type Selection

| Type | When to Use | SemVer | Example |
|------|-------------|--------|---------|
| `feat` | New feature added | MINOR | `feat(lore-0042): add user endpoints` |
| `fix` | Bug patched | PATCH | `fix(lore-0012): correct token expiry` |
| `docs` | Documentation only | - | `docs(lore-0005): add API reference` |
| `style` | Code formatting (no logic change) | - | `style: fix indentation` |
| `refactor` | Code restructure (no behavior change) | - | `refactor(lore-0017): extract validator` |
| `perf` | Performance improvement | PATCH | `perf(lore-0020): add query indexes` |
| `test` | Adding tests | - | `test(lore-0042): add auth unit tests` |
| `build` | Build system changes | - | `build: update webpack config` |
| `ci` | CI configuration | - | `ci: add GitHub Actions` |
| `chore` | Other changes (tooling, deps) | - | `chore: update dependencies` |
| `revert` | Reve