Skip to content

docs(#1636): clarify workflow_call nesting limits and thin-caller guidance - #1643

Closed
fullsend-ai-coder[bot] wants to merge 1 commit into
mainfrom
agent/1636-clarify-nesting-limits
Closed

docs(#1636): clarify workflow_call nesting limits and thin-caller guidance#1643
fullsend-ai-coder[bot] wants to merge 1 commit into
mainfrom
agent/1636-clarify-nesting-limits

Conversation

@fullsend-ai-coder

Copy link
Copy Markdown
Contributor

Update the stale 4-level workflow_call nesting limit to the current 10-level limit (50 calls per run, raised by GitHub in November 2025) in ADR 0041 and ADR 0031.

Add nesting arithmetic to ADR 0041 Consequences documenting the full synchronous chain (shim → dispatch → thin caller → reusable = 3 of 10 levels) and explaining why thin callers remain valuable despite consuming a nesting level: explicit secrets passthrough and vars to inputs mapping that makes the reusable workflow parameter contract visible and auditable.

Add a living-docs bullet to docs/architecture.md covering event-driven stage dispatch, nesting arithmetic, and thin-caller rationale.

Note: make lint could not run — pre-commit gitleaks hook fails to install in sandbox due to Go toolchain permission error. Changes are documentation-only (3 Markdown files); no Go code affected.


Closes #1636

Post-script verification

  • Branch is not main/master (agent/1636-clarify-nesting-limits)
  • Secret scan passed (gitleaks — 8480e16153a3f16c66b5484bfd4c76349a89933d..HEAD)
  • Pre-commit hooks passed (authoritative run on runner)
  • Tests ran inside sandbox

…dance

Update the stale 4-level workflow_call nesting limit to the current
10-level limit (50 calls per run, raised by GitHub in November 2025)
in ADR 0041 and ADR 0031.

Add nesting arithmetic to ADR 0041 Consequences documenting the full
synchronous chain (shim → dispatch → thin caller → reusable = 3 of
10 levels) and explaining why thin callers remain valuable despite
consuming a nesting level: explicit secrets passthrough and vars to
inputs mapping that makes the reusable workflow parameter contract
visible and auditable.

Add a living-docs bullet to docs/architecture.md covering event-driven
stage dispatch, nesting arithmetic, and thin-caller rationale.

Note: make lint could not run — pre-commit gitleaks hook fails to
install in sandbox due to Go toolchain permission error. Changes are
documentation-only (3 Markdown files); no Go code affected.

Closes #1636
@github-actions

Copy link
Copy Markdown

Site preview

Preview: https://abe0619b-site.fullsend-ai.workers.dev

Commit: 8f417131f064619bc932cd9b02f41a73e1bc1cfb

@fullsend-ai-review

Copy link
Copy Markdown

Review

Findings

No findings.

@fullsend-ai-review fullsend-ai-review Bot added the ready-for-merge All reviewers approved — ready to merge label May 28, 2026
@ifireball

Copy link
Copy Markdown
Member

Closing as this is already fixed in #1578

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ready-for-merge All reviewers approved — ready to merge

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Follow-up: clarify workflow_call nesting limits & thin-caller guidance (post ADR 0041)

1 participant