docs: align Claude Code adapter guidance with nested TaskMaestro+Teams model (#1310)

[JeremyDev87]

Summary

• Rewrites execution strategy documentation to reflect the intended nested model: TaskMaestro/SubAgent as outer parallel transport, Teams as optional inner coordination layer
• Adds explicit "Execution Model: Outer Transport vs Inner Coordination" section with architecture table and nested execution examples
• Marks Teams as experimental with capability gate wording — no longer implies Teams is a top-level strategy choice
• Updates .claude/rules/custom-instructions.md references to align with the nested model

Test plan

• yarn prettier --write . — no formatting changes
• yarn workspace codingbuddy exec tsc --noEmit — passes
• yarn workspace codingbuddy exec vitest run — 5893 tests pass
• Manual review of docs consistency

Closes #1310

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
codingbuddy-landing	Ready	Preview, Comment	Apr 4, 2026 10:49am

[JeremyDev87]

Review: ✅ APPROVE

CI Status: ALL PASS

Code Quality:

• claude-code.md: Replaced "Teams-preferred" with nested outer/inner model, added execution model section with clear examples
• custom-instructions.md: Updated strategy selection to "Outer Transport Selection", Teams as experimental inner layer
• Terminology clarity: TaskMaestro/SubAgent = outer transport, Teams = inner coordination (experimental)
• No code changes — pure documentation alignment

Checklist:

• CI ALL PASS
• Nested model clearly documented with examples
• Teams marked as experimental/capability-gated
• No over-promising of Teams behavior

✅ Adapter docs aligned with intended nested execution architecture.