backendforth/.github

Org-wide GitHub Actions reusable workflows for Slack PR notifications.

Workflows

pr-slack-summary.yml — PR open, merge, and close

All notification types share the same header (no duplicate title/repo lines elsewhere):

[emoji] New / Merged / Dependabot / Closed PR `title #number` (linked)
`owner/repo`

Event	Header label	Bar color
Human opened	✳️ New PR	green #2EB67D
Dependabot opened	🛄 New Dependabot PR	blue #439FE0
Merged	💟 Merged PR	purple #9B59B6 (human) / blue (Dependabot)
Closed without merge	📛 Closed PR	red #CB2431 (human) / blue (Dependabot)

On open — header, then metadata (status · opener · commit · tags · issues · files · lines), divider, Summary (from PR body ## Summary, code block, not AI), Breaking changes (code block), optional Documentation (only when breaking changes + links exist), View PR · Start review.

Dependabot opens also get a *Claude review* section @-mentioning Claude (<@U0BAPTE85TL>). /invite @Claude in #github-logs required.

On merge — header, merged-by · files · lines, View repo · View PR.

On close (not merged) — header, closed-by · opener, View repo · View PR.

Caller (per repo)

name: PR Slack notify

on:
  pull_request:
    types: [opened, ready_for_review, closed]
    branches: [main]   # + variant/document-level in next-sanity-starter

jobs:
  notify:
    uses: backendforth/.github/.github/workflows/pr-slack-summary.yml@main
    secrets: inherit

pr-slack-monthly-digest.yml — monthly overview

Runs for the previous calendar month. Posts totals, AI overview, highlights, contributors (humans, Dependabot, bots, Cursor/Claude/Copilot co-authors), dependency notes, and a PR index.

Caller (per repo)

name: PR monthly Slack digest

on:
  schedule:
    - cron: "0 6 1 * *"   # 1st of month, 06:00 UTC
  workflow_dispatch:

jobs:
  digest:
    uses: backendforth/.github/.github/workflows/pr-slack-monthly-digest.yml@main
    secrets: inherit

Org secrets

Secret	Purpose
SLACK_WEBHOOK_URL	Incoming Webhook → #github-logs (fallback when no bot token)
OPENROUTER_API_KEY	Dependabot breaking-change analysis
SLACK_BOT_TOKEN	Optional — xoxb-… with chat:write + reactions:write (posts + emoji reactions)
SLACK_CHANNEL_ID	Optional — #github-logs channel ID (C…)

When SLACK_BOT_TOKEN and SLACK_CHANNEL_ID are set, messages post via chat.postMessage and get an emoji reaction: :eyes: (new PR), :package: (Dependabot), :white_check_mark: (merged), :x: (closed). With webhook only, posting works but reactions do not (webhooks do not return a message timestamp).

Scope: all enrolled repos (next-sanity-starter, bef-website-2026, farbstudio.de, mammalsandcomputers).