本文へ移動
cccskills
無料GitHub で公開

foundations-cybernetics-vsm

Diagnoses stalled teams or agent hierarchies with Beer's VSM and Ashby's Law. Use when orchestrators overload, escalations pile up, or team boundaries need redesign.

インストール方法を見る

含まれるファイル(23)

  • SKILL.md14.6 KB
  • agents/openai.yaml371 B
  • assets/templates/cybernetics-vsm/01-feedback-loops.md3.8 KB
  • assets/templates/cybernetics-vsm/02-ashbys-law.md4.8 KB
  • assets/templates/cybernetics-vsm/03-vsm-system-1.md4.1 KB
  • assets/templates/cybernetics-vsm/04-vsm-system-2.md3.9 KB
  • assets/templates/cybernetics-vsm/05-vsm-system-3.md4.1 KB
  • assets/templates/cybernetics-vsm/06-vsm-system-3-star.md4.2 KB
  • assets/templates/cybernetics-vsm/07-vsm-system-4.md4.5 KB
  • assets/templates/cybernetics-vsm/08-vsm-system-5.md4.1 KB
  • assets/templates/cybernetics-vsm/09-recursion-levels.md5.8 KB
  • assets/templates/cybernetics-vsm/10-variety-engineering.md6.3 KB
  • assets/templates/cybernetics-vsm/11-algedonic-channels.md5.5 KB
  • assets/templates/cybernetics-vsm/README.md4.9 KB
  • data/sources.json15.3 KB
  • learnings.consolidated.md603 B
  • learnings.md622 B
  • references/composition-recipes.md5.9 KB
  • references/formal-theory-map.md4.4 KB
  • references/org-and-harness-mappings.md5.7 KB
  • references/patterns-scenarios-traps.md17.3 KB
  • references/primitives-overview.md7.9 KB
  • references/response-coverage-audit.md3.6 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Cybernetics and Viable System Model Foundations

When to Apply

Apply cybernetics-VSM when:

  • Org or agent-system steering question — viability, requisite variety, escalation paths
  • "Why does this team/system keep failing despite individual competence?" — likely missing S2/S3*/S4
  • Recursion across levels — same control pattern at squad / department / company
  • Algedonic channel design — when does a critical signal bypass hierarchy and reach S5 directly?
  • Variety-engineering — disturbance-to-signal-to-effective-response coverage (Ashby's Law)
  • An orchestrator agent or manager re-reviews everything and becomes the bottleneck; escalations pile up
  • "How many human reviewers do we need for N agents?" — answer with coverage and evidence, not a headcount ratio
  • Platform vs stream-aligned team boundaries (Team Topologies) where the question is who absorbs which demand

Skip and use simpler alternatives when:

  • Single team, no recursion, no orchestration question — VSM is overkill
  • Org-design question is purely about reporting lines — use a simple RACI, not VSM
  • Throughput/bottleneck question — use foundations-theory-of-constraints
  • Strategic-interaction question between agents — use foundations-game-theory
  • Feedback-loop tuning on a measurable variable — use foundations-control-theory
  • The framing imports VSM jargon (S1-S5) without an actual variety/viability problem — risk of decoration; demand the failure signal first

11 canonical cybernetics and VSM primitives for designing viable organizations, control hierarchies, and adaptive systems. Each primitive solves a specific failure mode in how complexity is absorbed, coordinated, and governed.

Quick Reference

#PrimitiveCore FunctionWhen to Reach For It
1Feedback LoopsRegulate behavior via negative (balancing) or amplify via positive (reinforcing) loopsAny adaptive control mechanism; stability vs. growth dynamics
2Ashby's Law of Requisite VarietyOnly regulator variety can reduce outcome variety (lower bound, log units)Diagnosing under-instrumented control; scaling management layers
3VSM System 1 — OperationsAutonomous operational units that do the actual workDefining work units, microservices, squads, agent executors
4VSM System 2 — CoordinationAnti-oscillation coordination layer between S1 unitsPreventing interference and thrashing between operational units
5VSM System 3 — Internal ControlHere-and-now optimization of the operational environmentPerformance management, resource allocation, policy enforcement
6VSM System 3* — Audit ChannelSporadic direct channel from S3 to S1 bypassing routine reportsSpot-checks, audits, compliance sampling; detecting reporting distortion
7VSM System 4 — IntelligenceOutside-and-future scanning; adaptation intelligenceStrategy, environmental scanning, roadmaps, horizon sensing
8VSM System 5 — Identity/PolicyUltimate authority; closure and identity of the wholeMission, values, constitutional rules, governance closure
9Recursion LevelsEvery viable system contains and is contained in viable systemsMulti-level organizational design; nesting teams, divisions, products
10Variety EngineeringAmplifiers, attenuators, and transducers to balance variety across channelsReducing information overload; designing dashboards, APIs, interfaces
11Algedonic ChannelsHigh-priority pain/pleasure signals that bypass normal hierarchy levelsIncident escalation, crisis bypass routes, critical alerts

Formal Supporting Theory

Load references/formal-theory-map.md when the task needs more than a primitive lookup: defining the system-in-focus, distinguishing first-order vs. second-order cybernetics, proving an Ashby/requisite-variety claim, mapping VSM systems 1-5 across recursion levels, or separating S3 control, S3* audit, S4 intelligence, S5 policy, and algedonic escalation.

Stafford Beer: VSM systems 1–5, algedonic channels, recursion levels and variety engineering are defined in Beer 1972 (Brain of the Firm), 1979 (The Heart of Enterprise) and 1985 (Diagnosing the System for Organizations). Cite Brain of the Firm by section title, not by a per-system chapter number; the book has no one-system-per-chapter structure. Chapter numbers cited for Beer 1985, Hoverstadt 2009 and Schwaninger 2006 are unverified; treat them as approximate.

Project Cybersyn (Chile, 1971–1973): the most-cited VSM deployment is also the most mythologised. Medina 2011 (Cybernetic Revolutionaries, MIT Press) is the archival history; read the fact-vs-myth table in references/patterns-scenarios-traps.md before citing the case. The figures in that table have not been re-checked against Medina; confirm them there before quoting.

W. Ross Ashby: the Law of Requisite Variety is in Ashby 1956 (An Introduction to Cybernetics, ch. 11; PDF). §11/7 gives a lower bound on outcome variety: V(O) ≥ V(D) − V(R) in logarithmic units, i.e. only regulator variety can reduce outcome variety, and by at most its own amount. In counts (§11/6): with d disturbances, r responses and no two equal outcomes in a response column, the regulator cannot hold the outcomes to fewer than d/r. Never subtract raw counts ("20 states − 5 levers = gap of 15"); use the response coverage audit. Siegenfeld & Bar-Yam (2025, Entropy 27(8), 835, DOI 10.3390/e27080835) generalise the law across scales; treat it as a clarification for recursive architectures, not a revision.

Requisite variety in AI-oversight regulation: Human oversight of an agent fleet needs enough variety to cover the fleet's disturbance classes, as in composition-recipes.md. Telukunta, Lilis & Baron (2026, arXiv:2608.10153, submitted 10 August 2026) apply Beer's VSM to enterprise agent fleets. Evidence grade: C (preprint, not peer-reviewed). Treat the CASE architecture as a conceptual proposal, not a validated quantitative condition; operational evidence must come from disturbance-response coverage and intervention tests. The underlying cybernetic sources are stronger evidence for the qualitative need for requisite variety, not for multiplying raw oversight counts. On the regulatory hook: EU AI Act Article 14 obligations differ by high-risk category and date; verify the applicable provision before making a current compliance claim.

Norbert Wiener: Feedback and cybernetics foundations from Wiener 1948 (Cybernetics: Or Control and Communication in the Animal and the Machine). Positive/negative feedback terminology is consistent with Wiener's original usage.

Espinosa & Walker: VSM applied to complexity and sustainability in A Complexity Approach to Sustainability (2011). Recursion and viable-systems analysis in real organisations.

Schwaninger: Intelligent organisations and VSM application in Intelligent Organizations (2006). Apply numeric claims (e.g., performance improvement percentages) only when derived from primary case studies, not secondary summaries.

Hoverstadt: Practical VSM application in The Fractal Organization (2009). Patterns cited from this source are practitioner heuristics — verify against Beer's original formalism before treating as universal.

Mechanism effectiveness is context-specific. Test variety-engineering interventions on a constrained scope before rolling out system-wide.

Misuse Boundaries

Load references/patterns-scenarios-traps.md before turning VSM into an org chart, central control layer, dashboard scheme, escalation policy, or agent hierarchy. It contains operational scenarios, anti-patterns, known traps, and a compact audit sequence.


Anti-Patterns

Anti-PatternCybernetics/VSM DiagnosisFix
System 3 collapses System 1 autonomy (micromanagement)S3 is consuming all operational variety — no recursion depth; Ashby violationRestore S1 autonomy; S3 sets policy and limits, not execution steps
System 4 disconnected from System 3 (strategy-execution gap)S4 output never reaches S3; no S3/S4 homeostatBuild explicit S3/S4 interface: shared planning cadence, mutual translation layer
Ashby's Law violated by under-instrumented controlDisturbance distinctions that require different responses are collapsed or unreachableDefine the disturbance classes and response repertoire; add attenuation or amplification where a tested control distinction is missing
Algedonic channel never used — S5 blind to crisesPain signals absorbed by normal hierarchy; S5 receives filtered reports onlyImplement direct bypass route with trigger threshold; test at an interval justified by hazard, disturbance rate, consequence deadline and change events
Recursion confusion — applying VSM at wrong organisational scaleS1/S3/S5 roles assigned to the wrong recursion levelRe-identify the level of recursion; redraw the system boundary before assigning roles
Positive feedback loop with no balancing loop (runaway dynamics)Reinforcing loop unchecked — growth, debt, or failure cascadesDesign an explicit negative feedback loop with a goal variable and measured deviation
S2 coordination layer absent — unit thrashingS1 units interfere without coordination signalsIntroduce S2 scheduling, resource-sharing protocols, or synchronisation mechanisms
S3* audit channel treated as normal management reportingSpot-check becomes routine; S1 adapts and Goodharts the signalKeep S3* sporadic and surprise-based; vary timing and scope
Variety amplified without attenuation at higher levelsUpper levels receive raw operational noise; decision paralysisApply variety attenuation (aggregation, exception filters) before variety reaches S3/S4
S5 identity undefined — policy vacuumS3/S4 conflicts escalate without resolution; ad-hoc decisions contradict each otherDefine S5 closure: mission, constraints, values; run S3/S4 conflicts through S5 reference frame
Human oversight of an agent fleet staffed, not engineeredReviewer headcount is added without mapping outcome-relevant agent behaviours to detectable signals and effective interventionsAdd triage, summarisation, tiered escalation, and tested intervention paths; publish the mapping and escalation SLA, not only a rota

Composition Recipes

Full stacks, checks and outputs: references/composition-recipes.md. Read it when a diagnosis needs several primitives in order.

RecipeUse whenPrimitives
Agent-Team Topology AuditAn orchestrator re-reviews every subagent result, escalations pile up, or you must size human oversight of an agent fleet#3, #4, #5, #2, #10, #11
Organisational Design for a StartupFounders are the bottleneck as layers appear#9, #3, #6, #7, #8, #1
Incident Escalation as Algedonic ChannelCrises sit in ticket queues or reach authority late#11, #8, #1, #6, #10
Scaling a Platform TeamA platform team queues every consumer request#2, #10, #4, #5, #1

Map a concrete agent harness or Team Topologies structure onto S1–S5, collect evidence that human oversight works, run a POSIWID check, or decide whether a small team needs S3*: references/org-and-harness-mappings.md.


Workflow

  1. Identify the system boundary and the level of recursion you are working at (use recursion levels #9 first).
  2. Map the five VSM systems to actual roles, teams, or agent components.
  3. Check for missing or collapsed systems using the "When to Reach For It" column of the Quick Reference.
  4. Apply Ashby's Law (#2) by testing the detection and effective-response path for each outcome-relevant disturbance class.
  5. Design or audit variety engineering (#10) mechanisms on each inter-level channel.
  6. Confirm algedonic channels (#11) exist and are tested.
  7. For specific failure modes, open the per-primitive playbook in assets/templates/cybernetics-vsm/.
  8. For multi-failure scenarios, use the Composition Recipes above.

Navigation

Learnings Loop

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.

日本語の概要は準備中です。原文の説明を表示しています。

vasilyu1983/AI-Agents-public932026年10月12日 更新

Configures and hardens Claude Code and Codex MCP servers. Use when connecting databases, APIs, SaaS, building servers, or serving a clearance-filtered knowledge base.

日本語の概要は準備中です。原文の説明を表示しています。

vasilyu1983/AI-Agents-public932026年10月12日 更新

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.

日本語の概要は準備中です。原文の説明を表示しています。

vasilyu1983/AI-Agents-public932026年10月12日 更新

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.

日本語の概要は準備中です。原文の説明を表示しています。

vasilyu1983/AI-Agents-public932026年10月12日 更新

Adds per-skill learnings loops for dated patterns, mistakes, and domain facts. Use when wiring skill memory, consolidation, or drift audits.

日本語の概要は準備中です。原文の説明を表示しています。

vasilyu1983/AI-Agents-public932026年10月12日 更新

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.

日本語の概要は準備中です。原文の説明を表示しています。

vasilyu1983/AI-Agents-public932026年10月12日 更新

vasilyu1983 のスキルをすべて見る

このスキルの問題を報告する