Part of #1011 — implements U8 of docs/plans/2026-07-30-001-feat-teams-plan.md. Depends on U1–U7.
Goal
Docs match shipped behavior.
Scope
- New
docs/runbooks/teams.md: team TOML format with a full example; cascade and shadowing rules (including that builtin member profile references resolve through the normal profile cascade, so a project reviewer profile shadows the builtin for team members too); selected_team + run-override precedence; delegate tool contract; top-level filtering semantics including the survival set (delegate force-appended; only AskUserQuestion force-granted otherwise — a team allowlist must carry its own read/search tools); the project-config trust posture; worktree-member note (worktree subagents cannot spawn subagents); TUI/GUI surfaces.
- CLAUDE.md: short Teams subsystem note per the existing epic-note convention.
- Any route/tool catalog docs enumerating
/v1/* routes or core tools updated.
- Runbook sample TOML pasted as a loader-test fixture in U1's suite so examples stay parseable.
Verification
Docs-alignment reading pass per CLAUDE.md ("public-facing docs stay aligned with current routes, run request fields, event names, tool catalog"); fixture test green.
Part of #1011 — implements U8 of
docs/plans/2026-07-30-001-feat-teams-plan.md. Depends on U1–U7.Goal
Docs match shipped behavior.
Scope
docs/runbooks/teams.md: team TOML format with a full example; cascade and shadowing rules (including that builtin member profile references resolve through the normal profile cascade, so a projectreviewerprofile shadows the builtin for team members too);selected_team+ run-override precedence;delegatetool contract; top-level filtering semantics including the survival set (delegateforce-appended; onlyAskUserQuestionforce-granted otherwise — a team allowlist must carry its own read/search tools); the project-config trust posture; worktree-member note (worktree subagents cannot spawn subagents); TUI/GUI surfaces./v1/*routes or core tools updated.Verification
Docs-alignment reading pass per CLAUDE.md ("public-facing docs stay aligned with current routes, run request fields, event names, tool catalog"); fixture test green.