Skip to content

ci: add semantic PR title check workflow #27

@dobby-coder

Description

@dobby-coder

Add semantic PR title check workflow

Currently this repo does not have a workflow that lints PR titles against the Conventional Commits spec. postguard-website already runs this via amannn/action-semantic-pull-request@v5 and it's worth standardising across the org so PR titles stay consistent (useful for changelogs, release-please, semantic-release, etc.).

Proposed workflow

Add .github/workflows/pr-title.yml:

name: PR Title

on:
  pull_request:
    types: [opened, edited, synchronize, reopened]

jobs:
  lint-pr-title:
    name: Conventional Commit
    runs-on: ubuntu-latest
    steps:
      - uses: amannn/action-semantic-pull-request@v5
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Why this isn't a PR

The dobby-coder[bot] GitHub App lacks the workflows: write permission, so it cannot push files under .github/workflows/. A maintainer needs to add this file by hand (or copy from postguard-website/.github/workflows/pr-title.yml).

Notes

  • Once enabled, PR titles must follow type: subject format (fix:, feat:, chore:, docs:, refactor:, test:, build:, ci:, perf:, style:, revert:).
  • The action lints the PR title, not commit messages.
  • If the check fails on an open PR, fixing the title (via the GitHub UI or the REST API) re-runs the check automatically.

Tracked org-wide from this agent's sweep on 2026-05-07.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions