# Source Command Commit

> Conventional commit with StarMapper scope auto-detection

- Skill: `florianbruniaux/source-command-commit` (Agent Skill)
- Install (CLI): `npx skillmds@latest add florianbruniaux/source-command-commit`
- Raw SKILL.md: https://api.skillmd.com/api/skills/florianbruniaux/source-command-commit/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: FlorianBruniaux (https://skillmd.com/u/florianbruniaux)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/florianbruniaux/source-command-commit

---


# source-command-commit

Use this skill when the user asks to run the migrated source command `commit`.

## Command Template

# Commit

Create a conventional commit following StarMapper conventions.

## Steps

1. `rtk git status` + `rtk git diff` — understand what changed
2. Detect scope from files:
   - `components/map/` → `map`
   - `app/api/chunk/` → `api`
   - `app/api/repo-info/` → `api`
   - `lib/geocoder.ts` → `geocoder`
   - `lib/github.ts` → `github`
   - `lib/db.ts` or `prisma/` → `db`
   - `app/page.tsx` or `app/[owner]/[repo]/page.tsx` → `ui`
   - `next.config`, `tsconfig`, `.Codex/`, `.env.example` → `config`
   - `package.json`, `pnpm-lock.yaml` → `deps`
3. **Scope Check** avant de stager :
   - Chaque fichier stagé est directement lié au changement en cours
   - Pas de "refactoring opportuniste" non demandé
   - Si un fichier n'est pas directement lié → commiter séparément
4. Stage specific files (never `git add -A`)
5. Commit with HEREDOC:

```bash
git commit -m "$(cat <<'EOF'
type(scope): imperative lowercase message

[Optional body: explain WHY, not what]

Co-Authored-By: Codex Sonnet 4.6 <noreply@anthropic.com>
EOF
)"
```

6. `rtk git status` to verify

## Types

- `feat` — new feature or capability
- `fix` — bug fix
- `perf` — performance improvement
- `refactor` — restructure without behavior change
- `chore` — deps, config, tooling
- `docs` — documentation only

## Examples

```
feat(map): add unmapped users drawer
fix(db): add url to datasource in schema.prisma
perf(geocoder): cache null results to skip re-geocoding
chore(deps): upgrade maplibre-gl to 5.21
fix(api): handle github graphql 429 rate limit
refactor(github): remove null cursor from graphql variables
feat(ui): add star count progress bar
fix(geocoder): normalize location key before cache lookup
```

## Rules

- **Granularity** : commiter APRÈS chaque changement logique terminé, pas tout à la fin
- Never stage `.env.local`, `.env*`, or any secrets
- Specify files explicitly — no `git add .`
- Message: imperative, lowercase, max 50 chars
- Body optional but valuable for non-obvious changes