Merge pull request 'docs: add subagent tool-budget guardrails for MCP tasks (Closes #259)' (#284) from docs/issue-259-subagent-tool-budget into master

This commit was merged in pull request #284.
This commit is contained in:
2026-07-07 03:43:47 -05:00
5 changed files with 159 additions and 1 deletions
+10
View File
@@ -3874,6 +3874,16 @@ _GUIDE_RULES = {
"paths (e.g. gitea_commit_files) for remaining mutations. Shell "
"unavailability never authorizes WebFetch/browser/manual-encoding "
"fallbacks (#258)."),
"subagent_tool_budget": (
"General-purpose subagents on deterministic MCP tasks must stay within "
"budget: single-step mutations (commit_files, create_pr, lock_issue) "
"max 15 tool calls / 5 min; review/merge queue inspection max 40 / "
"15 min. The main session with gitea.repo.commit must call "
"gitea_commit_files directly — no subagent delegation (#260). After "
"shell spawn failure (#258), attempt native MCP once; never authorize "
"WebFetch/Playwright/manual base64 when gitea_commit_files is "
"available. Never resume a failed subagent into a larger retry loop "
"(#259)."),
"subagent_delegation": (
"Deterministic write workflows (issue claim, branch creation, code "
"edits, commits, PR creation, review, merge, cleanup) run inline in "