A low dome of nested graphite shells is cut open to show two closed circulation loops inside, one with an impeller and one with a coiled spring, meeting at a central junction; a long knurled lever passes down through every shell to rest on that junction, its shaft inlaid in indigo, and the removed quarter of the shells is drawn as a ghosted outline.
Other

SystemsThinking

Structural analysis of complex systems — Iceberg model, Causal Loop feedback diagrams, archetype matching, Meadows leverage points, and concept maps — grounded in the premise that behavior is generated by structure

05
Workflows
00
Tools
03
References
10
Triggers

The Problem

Most debugging and problem-solving stops at the event layer. Something broke, you fix the thing that broke, and it breaks again next month in a slightly different way. Generic AI analysis does the same — it describes what happened, maybe traces one step back, and hands you a patch. The structural cause that keeps producing the problem sits three layers below the symptom, invisible unless you know to look for it. Recurring incidents, unintended consequences from 'fixes,' teams that keep running into the same friction — these are almost always structural problems being addressed at the event level.

How This Skill Approaches It

The skill runs five workflows grounded in Meadows, Senge, Forrester, and Ackoff. Iceberg walks a symptom down four layers — Events, Patterns, Structures, Mental Models — to find the cause that actually generates the behavior. CausalLoop maps the reinforcing (R) and balancing (B) feedback loops that produce a pattern, so you can see second-order effects before shipping a change. FindArchetype matches the behavior to one of ~10 canonical system archetypes (Limits to Growth, Shifting the Burden, Fixes That Fail, Tragedy of the Commons) and applies the documented intervention for that pattern. FindLeverage applies Meadows' 12 leverage points — ranked from weakest (parameters) to strongest (paradigm shifts) — to identify where intervention actually changes behavior. ConceptMap builds a Novak-style entity-relationship map for systems too tangled to hold in working memory.

Not for incident causal chains (use RootCauseAnalysis)

In Action

What you say to your DA, and what the SystemsThinking skill actually does.

  • You say "we keep getting paged for the same class of timeout, nothing we do sticks"
    Runs the Iceberg workflow: walks from the event (6 pages in 3 weeks) through patterns (all during deploy windows), to structure (auto-scaler cold-start latency exceeds health-check timeout during deploys), to the mental model underneath (deploys are safe if tests pass — but health checks aren't in the test path). Returns a structural fix, not another retry tweak.
  • You say "why does adding engineers past team size 12 slow us down instead of speeding us up"
    Runs FindArchetype: identifies the Limits to Growth pattern — a reinforcing loop (more engineers → more output → more hiring) constrained by a balancing loop (team size → coordination cost → per-engineer output drops). Names the canonical intervention: attack the balancing constraint (coordination mechanism), not the reinforcing loop.
  • You say "we're about to add a rate limit to stop abuse, what are the second-order effects"
    Runs CausalLoop: maps users, abusers, support load, and legitimate traffic into a causal loop diagram, surfaces the balancing loop (rate limit reduces abuse) alongside the reinforcing loop (rate limit causes legitimate retries → total load increases), and recommends per-identity limits with reputation scoring over per-IP blunt limits.

Inside the Skill

The thinking, frameworks, and architecture that distinguish this skill from a generic version of the same task.

Ideal State

  • Every analysis explains the behavior through the structure that generates it (loops, delays, incentives, flows, beliefs), never through the last event or a person.
  • The analysis starts from the facts and paths the request supplies and reads those paths rather than searching for them again. A supplied fact the conclusion rests on is checked at its source, a caller's hypothesis is never taken as fact, and a missing loop link or measured fact is read or measured at its source rather than inferred; any link still inferred is marked. Any search names the paths it covers, never the whole home tree or ~/Projects.
  • Evidence and inferred mechanism are told apart in every output, and every recommended intervention is traced through at least one round of its own feedback, with its second-order effects named, before it ships.
  • A recommendation is the highest-leverage change that is actually feasible, with a concrete first move and a date to re-evaluate it.
  • The recommendation names the specific file, hook, rule, metric or mechanism to change, and carries the input's measured facts (counts, rates, dates) through to it, so its effect can later be checked against the same numbers.
  • The actors are whatever actually acts in the system. In a solo operator's AI harness that is hooks, models, doctrine files, scheduled jobs and the principal; an organization, politics or culture is never invented to fit the frame.

Intent Routing

Intent Trigger File
Iceberg "iceberg model", "structural cause", "why does this keep happening", walk from symptom down to structure Intents/Iceberg.md
CausalLoop "causal loop", "feedback loop", "connection circle", "map relationships", build a CLD Intents/CausalLoop.md
FindArchetype "systems archetype", "recognize this pattern", "fixes that fail", "shifting the burden", "tragedy of the commons" Intents/FindArchetype.md
FindLeverage "leverage point", "where to intervene", "highest-leverage change", Meadows' 12 Intents/FindLeverage.md
ConceptMap "concept map", "map the entities", "relationship map", Novak-style mapping Intents/ConceptMap.md
File Read when
Foundation.md boundaries are contested, structures are informal, or the dynamics may mislead (Iceberg, CausalLoop)
Archetypes.md matching an archetype: discriminators and intervention safeguards (FindArchetype)
LeveragePoints.md ranking leverage: exceptions and intervention gates (FindLeverage)

Data & Config

User customizations, when present, live at <configRoot>/LIFEOS/USER/CUSTOMIZATIONS/SKILLS/SystemsThinking/ (configRoot is $CLAUDE_CONFIG_DIR when set, else ~/.claude). Any PREFERENCES.md, configurations or resources there override the defaults; when the directory does not exist, proceed with skill defaults. A History.md there, when present, records the install's own past runs and their measured facts; nothing reads it at run time.

Gotchas

No gotchas documented yet. Add failures here as they're discovered.

Examples

User: "Analyze the model router's feedback structure after a model swap: the router issues binding routes, the new main model declines about X% of them inline, and the delegation rate fell from A% to B%."
→ CausalLoop, then FindLeverage
→ Named R/B loops that keep work on the main model, and one leverage point naming the rule or meter to change, judged against the A%→B% figure
User: "Why does the LifeOS skill library keep accumulating overlapping skills (N now), and what structural leverage point would stop the sprawl rather than just pruning it once?"
→ Iceberg, FindArchetype, FindLeverage
→ Events to pattern to the structure that adds skills, the archetype it matches, and a structural change with a first move and a re-check date
User: "Why does a growing city keep running short of water after every reservoir expansion: feedback structure of supply, demand, pricing and drought"
→ CausalLoop, FindArchetype, FindLeverage
→ The loops and delays behind the recurring shortage, and the feasible interventions ranked by leverage
User: "A dashboard metric has shown the same frozen value for months and nobody noticed. What structure let it die silently?"
→ Iceberg, FindArchetype, FindLeverage
→ The independent failures behind the frozen value, each dated from the evidence, and a leverage point that catches the whole class of silent signal loss

Workflows & Routing · 5

Each workflow is one job the skill runs. The trigger phrases route your request to the right one — this is the skill's routing table.

  1. 01
    Iceberg Intents/Iceberg.md

    iceberg model, structural cause, why does this keep happening, walk from symptom down to structure

  2. 02
    CausalLoop Intents/CausalLoop.md

    causal loop, feedback loop, connection circle, map relationships, build a CLD

  3. 03
    FindArchetype Intents/FindArchetype.md

    systems archetype, recognize this pattern, fixes that fail, shifting the burden, tragedy of the commons

  4. 04
    FindLeverage Intents/FindLeverage.md

    leverage point, where to intervene, highest-leverage change, Meadows 12

  5. 05
    ConceptMap Intents/ConceptMap.md

    concept map, map the entities, relationship map, Novak-style mapping

How to Invoke

Say any of these to your DA and LifeOS activates the SystemsThinking skill automatically:

  • "systems thinking"
  • "causal loop"
  • "feedback loops"
  • "archetypes"
  • "leverage points"
  • "iceberg model"
  • "fix the system"
  • "why does this keep happening"
  • "recurring problem"
  • "second-order effects"

Or invoke explicitly:

Skill("SystemsThinking")

References · 3

Auxiliary files the skill loads at runtime — frameworks, guides, configs.

  • Archetypes
  • Foundation
  • LeveragePoints

Want LifeOS to do this for you?

Install LifeOS on your machine — your DA gets the SystemsThinking skill plus 96 others, all hooked into one Life OS.