Skip to content

[rig-claude] Improve Claude dynamic-workflow compatibility for rig - #357

Draft
github-actions[bot] wants to merge 1 commit into
mainfrom
rig-claude-compat/2026-08-05-eef6af05dd452809
Draft

[rig-claude] Improve Claude dynamic-workflow compatibility for rig#357
github-actions[bot] wants to merge 1 commit into
mainfrom
rig-claude-compat/2026-08-05-eef6af05dd452809

Conversation

@github-actions

@github-actions github-actions Bot commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

Compatibility gap addressed

The claude-workflow-conversion.md reference described how to port args, phase, log, parallel, pipeline, and call into a workflow({ body }), but never explained how to do a minimal first-step port for flat Claude dynamic workflow scripts — those whose orchestration code runs at the module top-level using injected globals (call, pipeline, parallel) rather than inside a body function.

A developer porting such a script had no clear path to rig/globals, which provides exactly those ambient proxies.

Why this improves transfer from Claude dynamic workflows to rig

Claude dynamic workflows inject call/pipeline/parallel as globals. The equivalent in rig is rig/globals, but it was only mentioned in dynamic-workflows.md and SKILL.md — not in the conversion reference a migrating developer would consult first.

This PR:

  1. Updates claude-workflow-conversion.md to document rig/globals as the minimal migration path for flat scripts — with a short inline example showing the pattern — and notes that body destructuring is preferred for new programs.

  2. Adds sample 340-flat-workflow-port.md showing a side-by-side Claude flat workflow → rig minimal port, with an explicit "Step 2" pointer to the fully idiomatic body form (310-workflow-audit-verify.md). This closes the missing two-step migration sample.

  3. Adds the new sample to the Example programs table in the conversion reference so it's discoverable alongside the other ports.

Files changed

  • skills/rig/references/claude-workflow-conversion.md — added rig/globals section with inline example; added 340 to the example programs table
  • skills/rig/samples/340-flat-workflow-port.md — new sample showing flat Claude-style port via rig/globals with pointer to idiomatic form

Validation run

npm run sample -- --testNamePattern="skill markdown samples typecheck"

All 464 tests passed (1 typecheck test run, 463 skipped).

Remaining intentional differences

None introduced. The behavior differences table in claude-workflow-conversion.md is unchanged.

Generated by Daily Rig Claude Dynamic Workflow Compatibility · sonnet46 55.3 AIC · ⌖ 8.53 AIC · ⊞ 5.4K ·

…ynamic workflows

- Update claude-workflow-conversion.md to document rig/globals as the
  migration path for flat top-level Claude dynamic workflow scripts that
  use call, pipeline, and parallel outside a body function
- Add sample 340-flat-workflow-port.md showing the minimal first-step port
  using rig/globals ambient proxies, with a pointer to the idiomatic body
  form as step 2
- Add sample 340 to the Example programs table in the conversion reference

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants