commit-conventionslisted

# Commit & branch conventions ## Branch ``` <TICKET-ID>_<short-kebab-description> ``` ## Commit ``` <type>(<scope>): <imperative summary> [<TICKET-ID>] ``` - `<type>` ∈ `feat` | `fix` | `chore`. Anything else → ASK. - `<scope>` = <YOUR SCOPE RULE — e.g. the component/module/service touched>. - `[<TICKET-ID>]` always at the end, in square brackets, matching the branch ticket id. ## One commit per branch per repo (amend-as-you-go) Every feature branch lands as **exactly one commit per repo**. `<main-branch>` below is filled at run time — read it off the repo's `CLAUDE.md`; never transcribe it here. ``` existing=$(git rev-list --count origin/<main-branch>..HEAD) if [ "$existing" -eq 0 ]; then git add <explicit-paths> && git commit -m "<message>" else git add <explicit-paths> && git commit --amend --no-edit fi ``` - Review-fix loops also amend: no follow-up "address review" commits. - The reviewer asserts `git rev-list --count origin/<main>..HEAD` returns `1`. - Never silently rewrite the message. If you disagree mid-flight → STOP and surface it. ## Never commit AI-infra files `.claude/`, MCP-state dirs, memory files. Use explicit paths in `git add` — never `git add -A`/`.`. **Three exceptions, decided by whether a fresh clone would need the file:** `.claude/agents/**` and `.claude/skills/**` are generated from this repo's `CLAUDE.md` and are product files. The repo's own `CLAUDE.md` is committable where `~/.claude/repo-allowlist` says so. Everything else under `.cla