builder: require durable workspace execution

agent_builder/skills/a2apack-agent-authoring/SKILL.md

@@ -101,7 +101,8 @@ class ResearchAgent(A2AAgent[ResearchConfig, NoAuth]):
                         ),
                     }
                 ]
-            }
+            },
+            config={"recursion_limit": 500},
         )
         report_text = _last_message_text(state)
         ref = await ctx.write_artifact(
@@ -127,6 +128,17 @@ If a skill calls `ctx.workspace_backend()` or `ctx.workspace`, declare
 `workspace_access`. If it writes user-visible files, also emit artifacts with
 `ctx.write_artifact` and `ctx.emit_artifact`.
 
+If a skill runs code, renderers, converters, or data tools that create
+downloadable files, run them through `await ctx.workspace_shell(...)` or
+`await ctx.workspace_python(...)` and make the command write under
+`/workspace/outputs/...`. In-process subprocesses write inside the agent pod,
+not the caller's mounted workspace.
+
+When invoking an inner DeepAgents graph, pass
+`config={"recursion_limit": 500}` to `graph.ainvoke(...)` or
+`graph.astream_events(...)`. Complex skill/subagent workflows can exceed
+LangGraph defaults during normal operation.
+
 If an agent needs system binaries, mirror the need in `a2a.yaml`:
 
 ```yaml