Skip to content

Labelling

Automatically labels PRs and issues using boring-cyborg. Changes under ./docs, for example, receive the documentation label.


Usage

.github/boring-cyborg.yml
---
# These settings are synced to GitHub by https://probot.github.io/apps/boring-cyborg/

_extends: gh-plumbing:.github/commons-boring-cyborg.yml

Shared labelling rules

.github/commons-boring-cyborg.yml
---
# <!--td-commons-settings-labels-start-->
labelPRBasedOnFilePath:
  cicd:
    - .github/workflows/**
  project-config:
    - .github/settings.yml
  chore:
    - .github/**
  documentation:
    - docs/**
    - mkdocs.yml
    - .github/ISSUE_TEMPLATE/**
    - .github/pull_request_template.md
  spec:
    - spec/**
# <!--td-commons-settings-labels-end-->

Label palette

commons-settings.yml declares the label palette. The Settings App applies it.

# Labels: define labels for Issues and Pull Requests
labels:
  - name: bug
    color: "#CC0000"
    description: An issue with the system.

  - name: enhancement
    color: "#336699"
    description: New functionality.

  - name: chore
    color: "#6e70ef"
    description: Maintenance

  - name: fix
    color: "#d73a4a"
    description: Conventional Commits type `fix` — bug fix.

  - name: feat
    color: "#a2eeef"
    description: Conventional Commits type `feat` — new feature.

  - name: docs
    color: "#0075ca"
    description: Conventional Commits type `docs` — documentation or spec change.

  - name: question
    color: "#3ffc8a"
    description: User question

  - name: documentation
    color: "#caa7e8"
    description: Update documentation.

  - name: cicd
    color: "#fbca04"
    description: ci/cd process functionality.

  - name: project-config
    color: "#ed979d"
    description: Change GitHub project config, keep a extra eye on merge.

  - name: breaking-change
    color: "#fc415d"
    description: Planed braking provider change.

  - name: duplicate
    color: "#cfd3d7"
    description: This issue or pull request already exists.

  - name: dependencies
    color: "#0366d6"
    description: Pull requests that update a dependency file.

  - name: wontfix
    color: "#ffffff"
    description: ""

  - name: automerge
    color: "#19F700"
    description: "Allow automatic Merge."

  - name: spec
    color: "#c5def5"
    description: Touches files under `spec/`.

  - name: skills
    color: "#bfdadc"
    description: Touches files under `skills/`.

  - name: agents
    color: "#c2e0c6"
    description: Touches files under `agents/`.

  - name: claude-code
    color: "#ffd33d"
    description: Touches Claude Code integration (`.claude/`, `.claude-plugin/`, `CLAUDE.md`).

  - name: release
    color: "#5319e7"
    description: Version-alignment PR — excluded from release-drafter changelog.

  - name: github-actions
    color: "#000000"
    description: Touches GitHub Actions workflows under `.github/workflows/`.

  - name: stale
    color: "#cccccc"
    description: Auto-applied by actions/stale to inactive issues and pull requests.