dev-gh-actions-doc-auto-merge

name	dev-gh-actions-doc-auto-merge
description	Create a GitHub Actions workflow that auto-merges a production branch into a documentation branch. Use when: (1) Setting up auto-sync from production to doc branch, (2) User mentions 'doc auto merge', 'auto sync docs', 'document branch sync', (3) User wants docs to stay up-to-date with production automatically.

Doc Branch Auto-Merge GitHub Actions Workflow

Create a GitHub Actions workflow that automatically merges a production branch into a documentation deploy branch, keeping docs up-to-date without manual sync.

Workflow

1. Confirm branch names

Ask the user to confirm (use AskUserQuestion):

• Document branch: The branch that triggers doc site deployment (default: doc)
• Production branch: The source-of-truth branch to merge from (default: main)

2. Check for existing workflow

Look for existing sync workflows in .github/workflows/ to avoid duplicates.

3. Create the workflow file

Create .github/workflows/sync-<production>-to-<doc>.yml:

name: Sync <production> to <doc> branch

# <production>ブランチへのpush時に<doc>ブランチへ自動マージ
# ドキュメントサイトが常に最新の<production>の内容を反映するようにする
on:
  push:
    branches: [<production>]

permissions:
  contents: write