Configures Claude Code hooks and Codex hooks.json/notify. Use when adding PreToolUse guards, Stop hooks, managed hooks, format-on-save, preflight, audits, or worktree/budget hooks.
日本語の概要は準備中です。原文の説明を表示しています。
Team-theory primitives for cooperative agents: what each subagent sees, when to communicate, aggregation, Shapley credit, coalition topology. Use when organizing subagents.
インストールする前に、エージェントに与えられる指示の中身を確認できます。
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.
まだレビューはありません。使ってみた感想をお寄せください。
概要と使いどころ
Configures Claude Code hooks and Codex hooks.json/notify. Use when adding PreToolUse guards, Stop hooks, managed hooks, format-on-save, preflight, audits, or worktree/budget hooks.
日本語の概要は準備中です。原文の説明を表示しています。
Configures and hardens Claude Code and Codex MCP servers. Use when connecting databases, APIs, SaaS, building servers, or serving a clearance-filtered knowledge base.
日本語の概要は準備中です。原文の説明を表示しています。
Owns instruction files: AGENTS.md, CLAUDE.md, personal and repo rules. Use when writing, pruning, auditing them, sharing rules across Claude and Codex, or fixing ignored rules.
日本語の概要は準備中です。原文の説明を表示しています。
Creates and audits agent skills: SKILL.md, references, scripts, runtime metadata. Use when writing, validating, or security-reviewing a skill, or fixing truncated skill listings.
日本語の概要は準備中です。原文の説明を表示しています。
Adds per-skill learnings loops for dated patterns, mistakes, and domain facts. Use when wiring skill memory, consolidation, or drift audits.
日本語の概要は準備中です。原文の説明を表示しています。
Chooses subagent, team, workflow, or debate and launches it on Claude Code or Codex. Use when delegating, running agent review boards, or installing shared agents.
日本語の概要は準備中です。原文の説明を表示しています。