executing-plans
executing-plans
Use when executing an implementation plan in the current session as the implementer yourself โ your human partner chose inline execution, or no subagent tool is available
foundations-team-theoryTeam-theory primitives for cooperative agents: what each subagent sees, when to communicate, aggregation, Shapley credit, coalition topology. Use when organizing subagents.
Independent GitHub snapshot ยท Automated classification ยท Original documentation governs
10 canonical team-theory primitives, plus an aggregation rule (#11: vote, debate, route, credit assignment, or coalition topology), for cooperative multi-agent decision problems โ agents share a payoff but each sees a different slice of the world. Game theory handles strategic conflict; decision theory handles solo choice under uncertainty; team theory handles the regime in between, which is exactly where subagents and orchestrated AI agents operate.
Apply team-theory when:
Skip and use simpler alternatives when:
Check this before reaching for any aggregation mechanism. The full decision table, the aggregation rows and their scope limits are in references/aggregation-and-multi-agent-evidence.md.
| # | Primitive | When to Reach For It |
|---|---|---|
| 1 | Team Decision Problem | Frame any shared-goal multi-agent setup before designing it |
| 2 | Information Structure | Decide what each agent observes; classify centralized / decentralized / partial / nested |
| 3 | Person-by-Person Optimality | Local optimality check โ necessary but not sufficient for team optimum |
| 4 | Value of Communication | "Should agents share state?" โ quantify expected payoff lift vs. cost |
| 5 | Radner's LQG Theorem | Classical convex LQG teams admit linear optimal rules under the theoremโs information assumptions |
| 6 | Witsenhausen Counterexample | Why naive linearity fails when one agent's action signals to another |
| 7 | Information Cost | Bound observation/communication budgets; rationalize bounded rationality |
| 8 | Organizational Forms | Pick centralized vs. decentralized vs. hierarchical structure; see #8a (centralize/decentralize decision test) and #8b (team-size/coordination-cost curve) in references/primitives-overview.md |
| 9 | Dec-POMDP / MARL Extension | Sequential team problems with state dynamics โ modern computational form |
| 10 | Common-Task Condition | Boundary condition: when does shared payoff actually hold? |
| 11 | Aggregation Rule (Vote / Debate / Route) | Combine agents' outputs: vote, debate, route to the strongest, calibrated selection; Shapley credit (templates 04, 17); coalition topology (22) |
Full definitions, inputs, outputs, failure modes, and worked examples: references/primitives-overview.md. Primitive #11 (aggregation): references/aggregation-and-multi-agent-evidence.md.
| Anti-Pattern | Team Theory Diagnosis | Fix |
|---|---|---|
| One central orchestrator reads everything, decides everything | Centralization may duplicate observations and communication cost | Compare centralized and decentralized policies under the actual information structure; invoke Radner-style linear optimality only after verifying the theorem's information and convexity assumptions |
| Each subagent given full system context "just in case" | Information cost (#7) ignored; redundant observations dominate token budget | Partition observations to what each agent's action depends on; redundancy must justify itself |
| Local optimization per subagent declared "team-optimal" | Person-by-person optimality (#3) confused with team optimum; PBPO is necessary, not sufficient | Search unilateral, pairwise and broader deviations to falsify candidate optimality; failed limited searches cannot certify a joint optimum |
| "Add a comms channel between agents" added without payoff analysis | Value of communication (#4) not computed; channel may cost more than it earns | Compute expected payoff with vs. without the channel; if delta < cost, drop it |
| "Multi-agent by default for complex tasks" | Coordination edges can grow quadratically under all-to-all coupling, but realized cost depends on topology; DPI only says post-processing cannot increase information about a target in a Markov chain, not that every routed message loses useful information | Measure the actual communication graph and compare against a single-agent baseline; use DPI only when its random variables and Markov condition are explicit |
| "Assume every text handoff is lossless" | Summaries may omit decision-relevant detail; LatentMAS is a specialized architecture, not a portable guarantee | Verify text/structured-artifact fidelity. Consider latent exchange only with embedding access, compatible representations and task-specific evidence; compare costs and outcomes locally |
| "Default to all-to-all communication between agents" | Dense graphs can increase cost and error propagation on evaluated tasks; no universal optimal sparsity follows | Compare sparse, dense and adaptive candidates under actual dependencies and matched budgets; preserve necessary channels |
| "Put the expert on the team and the team will use them" | Pappu et al. find expertise dilution; consensus-seeking also buys robustness to adversarial members | Compare competence routing and pooling against the best individual locally; also test robustness to unreliable contributions |
| Assume linear/affine policies optimal in non-LQG team | Witsenhausen (#6) shows nonlinear policies can dominate when signaling exists | Map action-dependent observations and information nestedness; consider nonlinear candidates when theorem premises fail, rather than excluding all signaling cases |
| Treat all multi-agent setups as game-theoretic | Common-task condition (#10) holds โ agents share a goal โ so mechanism-design overhead is wasted | Skip incentive compatibility; design for joint optimization directly |
| Treat all multi-agent setups as team problems | Common-task condition (#10) fails โ agents have divergent goals โ team theory underestimates conflict | Switch to game theory (auctions, mechanism design) |
| Importing human-team findings (c-factor, psychological-safety inverted-U) as agent-team design rules | These are contested human-team results, not team-theory primitives; they do not transfer to LLM agents without a local test | Use the observation partition (#2) and the aggregation rule (#11). Evidence and hedges live in startup-operating-system/references/people/team-effectiveness-evidence.md |
| Hierarchical orchestrator-worker with no information flow back up | Polyarchy/hierarchy structure (#8) chosen by default; loses bottom-up signal that decentralized form preserves | Add upward observation channel or switch to decentralized form; for tasks with parallelizable subtasks at suitable task scale, consider emergent self-organization protocols where agents self-assign roles (contested single preprint, Dochkina 2026; validate locally) |
| "Just add more agents/people, coordination scales for free" | Team-size/coordination-cost curve (#8b): pairwise channels grow ~n(n-1)/2 under high coupling (#8b) | Count how many existing members the new one must (not could) coordinate with; if most, cut coupling first (single owner for shared state) |
| "We are a centralized [org/agent system]" or "we are a decentralized one" applied blanket-wide | Centralize-vs-decentralize is a per-decision judgment (#8a: information compressibility, reversibility, coupling, blast radius of a wrong local call), not a company-wide or system-wide constant | Apply the four-question test per decision class; expect most real orgs and agent systems to be centralized on some decisions (shared state, brand, safety) and decentralized on others (local execution) |
startup-operating-system/references/people/team-effectiveness-evidence.md. Human media findings do not establish LLM transport choices.foundations-game-theory): references/aggregation-and-multi-agent-evidence.mdfoundations-game-theory): debate and audit โ adversarial debate, courtroom-style debate (PROClaim), meta-debate role routing, reasoning-tree audit; voting and consensus โ beyond majority voting, radial consensus score, conformal social choice, prediction market; coordination and credit โ belief-driven coordination (ECON), coalition formation routing, Shapley contribution scoring, online Shapley prompt evolutionstartup-operating-system; Westrum typology in software-ux-research): team-effectiveness-evidence.mddata/sources.jsonscripts/game_artifacts.py self-test that template 04 relies onstartup-operating-system: team-effectiveness-evidence.md.When prior decisions or pitfalls are relevant, consult learnings.consolidated.md if present; use learnings.md only for needed history or as the available fallback. Otherwise skip both.
After applying it, if you encountered a pattern worth remembering, a mistake worth preventing, or a domain fact that surprised you, append one dated bullet to learnings.md via agents-skills-feedback-loop/scripts/append_learning.py. Do not modify SKILL.md itself.