Changelog Generator

Add the commit linter as a required CI check:

# .github/workflows/validate.yml
jobs:
  commit-lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0  # required to access full commit history

      - name: Lint PR commits
        run: |
          python3 scripts/commit_linter.py \
            --from-ref origin/main \
            --to-ref HEAD \
            --strict \
            --format text
        # --strict exits 1 on any violation, failing the check

What gets blocked vs. allowed:

# BLOCKED
fix stuff              missing conventional prefix
WIP                    no type
asdfgh                 no type
Feat: Add login        wrong case (must be lowercase)

# ALLOWED
feat(auth): add OAuth2 login with Google
fix(api): return 404 when user not found instead of 500
feat!: remove GET /v1/users/search endpoint
  BREAKING CHANGE: use GET /v1/users?q= instead

Pair with a PR template (.github/pull_request_template.md):

## Commit format reminder
- `feat(scope): description` — new feature
- `fix(scope): description` — bug fix
- `feat!: description` — breaking change (bumps major)

See: [Conventional Commits](https://www.conventionalcommits.org)

In GitHub: Settings → Branches → require the commit-lint status check before merging.

This skill includes executable scripts — I'll need your permission before running them.

Run the generator once per package with --scope:

for pkg in api web mobile infra; do
  python3 scripts/generate_changelog.py \
    --from-tag v1.3.0 \
    --to-tag HEAD \
    --next-version "$(cat packages/$pkg/VERSION)" \
    --scope $pkg \
    --write packages/$pkg/CHANGELOG.md
done

Routing logic:

• feat(api): ... → packages/api/CHANGELOG.md only
• fix(web): ... → packages/web/CHANGELOG.md only
• feat: ... (no scope) → root CHANGELOG.md only
• chore(infra): ... → packages/infra/CHANGELOG.md but omitted from user-facing sections

Independent semver bump per package:

packages/api   — has feat(api)! → major → v2.0.0
packages/web   — only fix(web): → patch → v1.3.1
packages/mobile — feat(mobile): → minor → v1.4.0
packages/infra — chore(infra): → no user-facing bump

Enforce scope discipline with the linter:

# Validate that scope names match actual package names
python3 scripts/commit_linter.py \
  --from-ref origin/main --to-ref HEAD \
  --allowed-scopes api,web,mobile,infra \
  --strict

This prevents feat(backend): (wrong name) from being silently excluded from the api package changelog.