git-conventionslisted
Install: claude install-skill a-novel-kit/stack
# Git Conventions
This skill governs workspace state, branch naming, and commit messages across all Agora backend
services. Every branch and commit produced by an agent follows these conventions exactly — they
drive automation (Renovate, CI tagging, changelogs) and signal intent to reviewers at a glance.
---
## Commit Messages — Conventional Commits
All commits use the [Conventional Commits](https://www.conventionalcommits.org/) format:
```
<type>(<scope>): <description>
[optional body]
[optional footer(s)]
```
### Types
| Type | Use when… |
| ---------- | ------------------------------------------------------------- |
| `feat` | Adding a new capability (endpoint, field, algorithm) |
| `fix` | Correcting a bug or incorrect behaviour |
| `refactor` | Restructuring code without changing behaviour or API surface |
| `perf` | Performance improvement with no functional change |
| `test` | Adding or fixing tests only |
| `docs` | Documentation only (comments, doc.go, openapi.yaml, SKILL.md) |
| `chore` | Maintenance that doesn't fit above (deps, CI, build scripts) |
| `ci` | CI/CD pipeline changes only |
| `revert` | Reverting a previous commit |
Never mix types in one commit. A commit that adds a handler AND its test is still `feat` — the