Skip to content

ci: add docs-sync workflow to open PRs against dojoengine/book#552

Open
kronosapiens wants to merge 1 commit intodojoengine:mainfrom
kronosapiens:ci/docs-sync-workflow
Open

ci: add docs-sync workflow to open PRs against dojoengine/book#552
kronosapiens wants to merge 1 commit intodojoengine:mainfrom
kronosapiens:ci/docs-sync-workflow

Conversation

@kronosapiens
Copy link
Copy Markdown

@kronosapiens kronosapiens commented Apr 23, 2026

Adds a caller stub that invokes the shared reusable docs-sync workflow hosted in dojoengine/book.

What it does

On each merged PR to main (plus manual workflow_dispatch), the stub calls dojoengine/book/.github/workflows/docs-sync.yml@main with this repo's parameters (diff globs, DOCS_PATTERNS, canonical docs page). The shared workflow diffs the PR, runs anthropics/claude-code-action@beta with a tight "default to no changes / single canonical location / minimal edits" ruleset, and — if Claude made edits — opens an auto-merging PR to dojoengine/book with the suggested changes.

Per-repo parameters

See the with: block in the diff. Canonical docs location for this repo:

katana: docs/pages/toolchain/katana/ in dojoengine/book.

Requires these secrets (forwarded via secrets: inherit)

  • CREATE_PR_TOKEN — PAT with contents: write on dojoengine/book.
  • ANTHROPIC_API_KEY — for anthropics/claude-code-action@beta.

Merge order

Merge dojoengine/book#504 first — that's what adds the reusable workflow this stub references. Merging this stub before that one means the workflow will fail at invocation time (the uses: ref won't resolve).

Related

Companion stub PRs across the dojoengine ecosystem, all pointing at the same reusable workflow:

Cross-org companion stub:

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 targeted docs updates.

Canonical docs location: docs/pages/toolchain/katana/

Requires repository secrets: CREATE_PR_TOKEN, ANTHROPIC_API_KEY.
@kronosapiens kronosapiens force-pushed the ci/docs-sync-workflow branch from bd9edbf to 39f88a6 Compare April 23, 2026 17:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant