ci: add reusable docs-sync workflow for the dojoengine ecosystem

[kronosapiens]

Adds a single reusable workflow at .github/workflows/docs-sync.yml that consolidates the per-repo docs-sync workflows across the dojoengine ecosystem plus cartridge-gg/controller.

Why here

dojoengine/book is the natural home: it's the primary target docs repo, and it's public, which means cross-org callers (cartridge-gg/controller → cartridge-gg/docs) can invoke it without any access-setting juggling.

How callers use it

Each source repo shrinks from ~200 lines of duplicated workflow to a ~30-line stub:

name: doc-sync
on:
  pull_request: { types: [closed], branches: [main] }
  workflow_dispatch:
    inputs:
      commit_sha: { 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/katana
      diff-globs: |
        *.rs
        *.toml
      docs-patterns: |
        ^crates/.*\.rs$
        ^bin/.*\.rs$
      canonical-desc: "Katana is documented at docs/pages/toolchain/katana/ ..."
      docs-structure-desc: "The site uses Vocs. Content lives in docs/pages/ ..."
    secrets: inherit

Inputs

Input	Purpose
target-docs-repo	owner/name of the docs repo to open PRs against (e.g., dojoengine/book, cartridge-gg/docs)
source-repo-slug	owner/name of the caller (e.g., dojoengine/katana). Short name is derived as ${slug##*/} — no separate name input needed.
diff-globs	newline-separated pathspec globs passed to git diff --
docs-patterns	newline-separated bash regexes; a changed file matching any triggers docs-sync
canonical-desc	prose telling Claude which single page/section owns this caller's docs
docs-structure-desc	prose describing the target docs repo's layout (Vocs content root, nav path, conventions)

Secrets are forwarded via secrets: inherit — each caller keeps its own CREATE_PR_TOKEN and ANTHROPIC_API_KEY, no new secrets land in this repo.

What the reusable workflow does

Same pipeline as the previously-per-repo versions:

1. Checks out the source repo, computes diff between PR base and merge commit (or the manual commit_sha).
2. Filters changed files against docs-patterns — if nothing matches, exits.
3. Truncates the diff to 60KB and invokes anthropics/claude-code-action@beta with a tight ruleset (default to no changes, single canonical location, minimal edits, one code example per concept, never create new top-level sections).
4. If Claude made edits, branches docs-update-<timestamp> on the target docs repo, commits, opens an auto-merging PR back-linking to the source PR.

Related PRs

Once this merges, these existing per-repo PRs will have the stubs take effect:

• ci: add docs-sync workflow to open PRs against dojoengine/book dojo#3405
• ci: add docs-sync workflow to open PRs against dojoengine/book katana#552
• ci: add docs-sync workflow to open PRs against dojoengine/book torii#427
• ci: add docs-sync workflow to open PRs against dojoengine/book torii-core#68
• ci: add docs-sync workflow to open PRs against dojoengine/book saya#71
• chore: add docs-sync workflow to open PRs against dojoengine/book dojo.js#528
• ci: add docs-sync workflow to open PRs against dojoengine/book dojo.c#165
• ci: add docs-sync workflow to open PRs against dojoengine/book dojo.unity#117
• ci: add docs-sync workflow to open PRs against dojoengine/book dojo.unreal#2
• ci: add docs-sync workflow to open PRs against dojoengine/book dojo.bevy#6
• ci: migrate docs-sync to reusable workflow in dojoengine/book cartridge-gg/controller#2572

Sourced from cartridge-gg/controller/.github/workflows/docs-sync.yml with all per-repo variation extracted to workflow_call inputs.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
book	Ready	Preview	Apr 23, 2026 3:45pm