lmiranda
2d51df7a42
Phase 1b: Rename all ~94 commands across 12 plugins to /<noun> <action> sub-command pattern. Git-flow consolidated from 8→5 commands (commit variants absorbed into --push/--merge/--sync flags). Dispatch files, name: frontmatter, and cross-reference updates for all plugins. Phase 2: Design documents for 8 new plugins in docs/designs/. Phase 3: Scaffold 8 new plugins — saas-api-platform, saas-db-migrate, saas-react-platform, saas-test-pilot, data-seed, ops-release-manager, ops-deploy-pipeline, debug-mcp. Each with plugin.json, commands, agents, skills, README, and claude-md-integration. Marketplace grows from 12→20. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
96 lines
2.0 KiB
Markdown
96 lines
2.0 KiB
Markdown
# Commit Conventions
|
|
|
|
## Purpose
|
|
|
|
Defines conventional commit message format for consistent, parseable commit history.
|
|
|
|
## When to Use
|
|
|
|
- Generating commit messages in `/gitflow commit`
|
|
- Validating user-provided commit messages
|
|
- Explaining commit format to users
|
|
|
|
## Message Format
|
|
|
|
```
|
|
<type>(<scope>): <description>
|
|
|
|
[optional body]
|
|
|
|
[optional footer]
|
|
```
|
|
|
|
## Commit Types
|
|
|
|
| Type | Purpose | Example Scope |
|
|
|------|---------|---------------|
|
|
| `feat` | New feature | `auth`, `api`, `ui` |
|
|
| `fix` | Bug fix | `login`, `validation` |
|
|
| `docs` | Documentation only | `readme`, `api-docs` |
|
|
| `style` | Formatting, whitespace | `lint`, `format` |
|
|
| `refactor` | Code change (no bug fix, no feature) | `auth-module` |
|
|
| `perf` | Performance improvement | `query`, `cache` |
|
|
| `test` | Adding/updating tests | `unit`, `e2e` |
|
|
| `chore` | Maintenance tasks | `deps`, `build` |
|
|
| `build` | Build system or dependencies | `webpack`, `npm` |
|
|
| `ci` | CI configuration | `github-actions` |
|
|
|
|
## Scope Detection
|
|
|
|
Derive scope from changed files:
|
|
- `src/auth/*` -> `auth`
|
|
- `src/api/*` -> `api`
|
|
- `tests/*` -> `test`
|
|
- `docs/*` -> `docs`
|
|
- Multiple directories -> most significant or omit
|
|
|
|
## Examples
|
|
|
|
**Feature commit:**
|
|
```
|
|
feat(auth): add password reset flow
|
|
|
|
Implement forgot password with email verification.
|
|
Includes rate limiting (5 attempts/hour) and 24h token expiration.
|
|
|
|
Closes #123
|
|
```
|
|
|
|
**Bug fix:**
|
|
```
|
|
fix(ui): resolve button alignment on mobile
|
|
|
|
The submit button was misaligned on screens < 768px.
|
|
Added responsive flex rules.
|
|
```
|
|
|
|
**Maintenance:**
|
|
```
|
|
chore(deps): update dependencies
|
|
|
|
- typescript 5.3 -> 5.4
|
|
- react 18.2 -> 18.3
|
|
- node 18 -> 20 (LTS)
|
|
```
|
|
|
|
## Footer Conventions
|
|
|
|
| Footer | Purpose |
|
|
|--------|---------|
|
|
| `Closes #123` | Auto-close issue |
|
|
| `Refs #123` | Reference without closing |
|
|
| `BREAKING CHANGE:` | Breaking change description |
|
|
| `Co-Authored-By:` | Credit co-author |
|
|
|
|
## Co-Author Footer
|
|
|
|
When Claude assists with commits:
|
|
```
|
|
Co-Authored-By: Claude <noreply@anthropic.com>
|
|
```
|
|
|
|
## Related Skills
|
|
|
|
- skills/branch-naming.md
|
|
- skills/git-safety.md
|