From 9e6eb615397e973833ce42d6fc756815a324d8b5 Mon Sep 17 00:00:00 2001
From: kronosapiens <kronovet@gmail.com>
Date: Thu, 23 Apr 2026 10:14:59 -0400
Subject: [PATCH] ci: add docs-sync workflow to open PRs against
 dojoengine/book

Ports the docs-sync workflow from cartridge-gg/controller to this repo.
On each merged PR to main (and on manual workflow_dispatch), Claude analyzes
the diff and, if user-facing behavior changed, opens an auto-merging PR to
dojoengine/book with the suggested docs updates.

Requires repository secrets: CREATE_PR_TOKEN, ANTHROPIC_API_KEY.
---
 .github/workflows/docs-sync.yml | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)
 create mode 100644 .github/workflows/docs-sync.yml

diff --git a/.github/workflows/docs-sync.yml b/.github/workflows/docs-sync.yml
new file mode 100644
index 0000000..530283e
--- /dev/null
+++ b/.github/workflows/docs-sync.yml
@@ -0,0 +1,33 @@
+name: docs-sync
+
+on:
+  pull_request:
+    types: [closed]
+    branches: [main]
+  workflow_dispatch:
+    inputs:
+      commit_sha:
+        description: "Commit SHA to analyze for documentation updates"
+        required: true
+        type: string
+
+jobs:
+  docs-sync:
+    if: github.event.pull_request.merged == true || github.event_name == 'workflow_dispatch'
+    uses: dojoengine/book/.github/workflows/docs-sync.yml@main
+    with:
+      target-docs-repo: dojoengine/book
+      source-repo-slug: dojoengine/dojo.unreal
+      diff-globs: |
+        *.h
+        *.cpp
+        *.hpp
+        *.md
+      docs-patterns: |
+        ^Source/.*\.(h|cpp|hpp)$
+        ^Plugins/.*\.(h|cpp|hpp)$
+      canonical-desc: |
+        The Unreal Engine SDK is documented on a SINGLE PAGE: docs-repo/docs/pages/client/sdk/unrealengine.md. Do NOT create new pages or subdirectories under client/sdk/.
+      docs-structure-desc: |
+        The site uses Vocs. Content lives in `docs-repo/docs/pages/`. Navigation is in `docs-repo/routes.ts`. SDK docs at `docs-repo/docs/pages/client/sdk/` are single `.md` files (bevy.md, javascript.md, unity.md, unrealengine.md, godot.md, rust.md, telegram.md), not subdirectories — the sole exception is `c/` which is a subdir.
+    secrets: inherit