/commit

Commit Command

Create atomic conventional commits from staged and unstaged changes.

Usage

/ja:commit              # Auto-detect and commit all changes
/ja:commit "message"    # Use provided message hint

Core Principles

1. Atomic Commits: One logical change per commit
2. Conventional Commits: Follow the spec (feat, fix, docs, style, refactor, perf, test, build, ci, chore)
3. No AI Attribution: Never include Co-Authored-By or Generated with lines
4. Always Push: Batch push all commits after creation

Forbidden Content

NEVER include in commit messages:

• Generated with [Claude Code]
• Co-Authored-By: Claude
• Any AI tool attribution
• Any co-authorship mentions

Workflow

1. ANALYSE

git status
git diff --staged --name-status
git diff --name-status

Categorise changes by file type and determine grouping strategy.

2. PLAN

Group changes by type:

Group	Types	Examples
Infrastructure	build, ci, chore	Config files, dependencies
Architecture	refactor, perf	Code restructuring
Features	feat	New functionality
Fixes	fix	Bug fixes
Testing	test	Test files
Documentation	docs	README, comments
Styling	style	Formatting

3. EXECUTE

For each commit group:

git add [relevant_files]
git commit -m "type(scope): description"

Commit message format:

type(scope): subject

body (optional - explain why, not what)

footer (optional - breaking changes, issue refs)

• Subject: Imperative mood, no period, max 72 chars
• Body: Explain why, not what
• Footer: Breaking changes, issue references

4. VERIFY

git log -n [number_of_commits] --oneline

Scan for forbidden AI attribution content.

5. PUSH

git push
# or for new branches:
git push -u origin $(git branch --show-current)

Commit Sequence Example

Instead of one large commit:

git commit -m "feat: massive update with everything"

Create atomic sequence:

git commit -m "chore: add linting configuration"
git commit -m "refactor(api): enhance utility functions"
git commit -m "feat(users): implement user creation"
git commit -m "test: add user management tests"
git push

Pre-Commit Validation

Before ANY git commit:

1. Verify message contains NO "Generated with" text
2. Verify message contains NO "Co-Authored-By: Claude"
3. Verify message contains NO AI/bot references
4. If ANY validation fails, recreate message without these lines