Skip to content

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

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#427
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:

torii (full Dojo indexer): docs/pages/toolchain/torii/ 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 the suggested docs updates.

Requires repository secrets: CREATE_PR_TOKEN, ANTHROPIC_API_KEY.
@kronosapiens kronosapiens force-pushed the ci/docs-sync-workflow branch from 03a2cbf to e6145d5 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