agentleFS
zbbsdsbzbbsdsb/solo-corn-skills/systems-orchestrator/SKILL.md

systems-orchestrator

Skill7 starsChanged 5 months agoMITView on GitHub

The symptom you see is downstream from the structure you built." Systems thinking for founders: map causal loops, find leverage points, trace effects, diagnose delays, and match system archetypes.

The file

We split this skill into the rules it gives an agent

12 rules. About 0 are common, 12 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈12

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Identify Feedback: Look for loops that form as effects propagate

    line 111
  2. Distinctive:

    Map the Timeline: Document when actions happen and when results appear

    line 127
  3. Distinctive:

    Compare to Archetypes: Check for matches:

    line 147
  4. Distinctive:

    Apply Archetype Solutions: Use known interventions for that pattern

    line 154
  5. Distinctive:

    Shortcut: If it's clearly one of the classic archetypes, you can jump straight to archetype-match, but mapping first is still recommended.

    line 186
  6. Distinctive:

    Use systems thinking to map the strategic landscape

    line 191
  7. Distinctive:

    Use questioning to uncover hidden system structures

    line 198
  8. Distinctive:

    Document principles for avoiding common archetypes

    line 200
  9. Distinctive:

    Start Simple: Don't try to map everything at once—focus on the 5-10 most important variables

    line 343
  10. Distinctive:

    Go High on Leverage: Don't waste time on parameter tweaks when you could change the paradigm

    line 348
  11. Distinctive:

    Archetype Library: Add new archetypes as you discover them in your context

    line 364
  12. Distinctive:

    Leverage Point Case Studies: Document what actually worked in your startup

    line 365

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Systems Orchestrator Skill

Overview

The Systems Orchestrator is a framework for founders to see beyond symptoms and understand the underlying structures that drive their startups' behavior. It equips you to diagnose complex problems, identify high-leverage interventions, and anticipate cascading effects of your decisions.

Core Philosophy: "The symptom you see is downstream from the structure you built."

This skill provides a structured approach to:

  • Map Systems: Visualize causal relationships and feedback loops
  • Find Leverage: Identify where small changes create big impacts
  • Trace Effects: Anticipate cascading consequences of decisions
  • Diagnose Delays: Uncover time lags that cause oscillation and instability
  • Match Archetypes: Recognize classic system patterns to apply proven solutions

Why Systems Thinking Matters for Founders

Startup challenges rarely have simple, single-cause solutions. Problems like:

  • User acquisition that oscillates up and down
  • Team burnout that keeps recurring
  • Growth that stalls despite more spending
  • Quality issues that persist despite fixes

are often symptoms of underlying system structures, not isolated problems. Systems thinking helps you see the whole picture and fix the root cause, not just the symptom.

Key Concepts

  • Stocks: Accumulations (users, cash, technical debt, morale)
  • Flows: Rates of change (signups, churn, hiring, burnout)
  • Feedback Loops: Circular relationships where outputs affect inputs
    • Reinforcing Loops: "Virtuous/vicious cycles" that amplify change
    • Balancing Loops: Stabilizing forces that push back toward equilibrium
  • Delays: Time lags between actions and results
  • Archetypes: Common, recurring system patterns

Core Operations

1. map-system: Build a Causal Loop Diagram (CLD)

Visualize the system's structure by mapping causal relationships and feedback loops.

Step-by-Step Protocol:

  1. List Key Variables: Identify the key elements in your system (e.g., users, marketing spend, churn, team size, morale)
  2. Map Causal Links: Draw connections between variables:
    • A → B means "A causes B to change in the same direction"
    • A ← B means "A causes B to change in the opposite direction"
  3. Identify Loops: Trace circular relationships and label them:
    • R: Reinforcing loop (amplification)
    • B: Balancing loop (stabilization)
  4. Add Delays: Mark time lags with || symbols
  5. Validate: Walk through the diagram with stakeholders to ensure it reflects reality

Key Questions:

  • What are the most important stocks and flows?
  • What drives each variable up or down?
  • Where are the circular relationships?
  • What are we missing?

2. find-leverage: Apply Meadows' 12 Leverage Points

Identify where interventions will have the greatest impact using Donella Meadows' hierarchy of leverage points (from most to least powerful):

Step-by-Step Protocol:

  1. Map the System First: Complete a CLD before searching for leverage
  2. Work Through the Hierarchy: Evaluate each leverage point category:
    1. Transcending Paradigms: The mindset behind the system
    2. Paradigms: The shared assumptions that shape goals
    3. Goals: The purpose of the system
    4. Self-Organization: The system's ability to evolve
    5. Rules: Incentives, constraints, policies
    6. Information Flows: Who gets what data when
    7. Reinforcing Loops: The gain around amplifying cycles
    8. Balancing Loops: The strength of stabilizing feedback
    9. Delays: The timing of feedback
    10. Stock-and-Flow Structures: Physical systems and capacities
    11. Buffers: The size of stabilizing stocks
    12. Numbers: Constants and parameters (least powerful)
  3. Prioritize: Focus on higher-leverage points first

Key Questions:

  • What paradigm is driving our current approach?
  • What if we changed the system's goal entirely?
  • Where is information missing or delayed?
  • What rules could we change?

3. trace-effects: Simulate Cascading Consequences

Anticipate second-, third-, and Nth-order effects of a decision.

Step-by-Step Protocol:

  1. Define the Intervention: Clearly state what you're changing
  2. Trace First-Order Effects: What changes immediately?
  3. Trace Second-Order Effects: What changes as a result of the first-order effects?
  4. Continue N Levels: Go at least 3-4 levels deep
  5. Identify Feedback: Look for loops that form as effects propagate
  6. Consider Time Horizons: What happens in 1 week? 1 month? 1 year?
  7. Search for Unintended Consequences: "What could go wrong that we didn't expect?"

Key Questions:

  • What are we not thinking about?
  • What balancing loops might activate?
  • What reinforcing loops might we trigger?
  • Who/what else is affected?
  • What delays might mask effects?

4. diagnose-delays: Uncover Time Lags Causing Problems

Delays often cause oscillation, instability, and wrong decisions.

Step-by-Step Protocol:

  1. Look for Oscillation: Is the system bouncing up and down? (classic delay symptom)
  2. Map the Timeline: Document when actions happen and when results appear
  3. Categorize Delay Types:
    • Perception Delays: Time to notice a change
    • Response Delays: Time to decide and act
    • Delivery Delays: Time for action to have effect
  4. Quantify: Estimate how long each delay lasts
  5. Test Interventions: Simulate reducing or eliminating delays

Key Questions:

  • Where are we waiting for information?
  • Where is action taking too long?
  • Are we overreacting because we don't see results yet?
  • What if we shortened this delay?

5. archetype-match: Recognize Classic System Patterns

Match your situation to common archetypes to access proven solutions.

Step-by-Step Protocol:

  1. Describe Symptoms: What's happening behaviorally?
  2. Build a Partial CLD: Map the key relationships you see
  3. Compare to Archetypes: Check for matches:
    • Fixes That Fail: A solution creates new problems worse than the original
    • Shifting the Burden: Addicting to symptomatic fixes instead of addressing root cause
    • Limits to Growth: A reinforcing loop hits a balancing limit
    • Eroding Goals: Gradually lowering standards as feedback is delayed
    • Escalation: Competitive arms race (e.g., price wars)
    • Success to the Successful: Winners keep winning, accumulating advantage
  4. Apply Archetype Solutions: Use known interventions for that pattern
  5. Adapt: Tailor solutions to your specific context

Key Archetypes & Solutions:

ArchetypeSymptomsSolution
Fixes That FailProblem comes back worseStop the fix; address root cause
Shifting the BurdenDependency on symptomatic fixesStrengthen the fundamental solution
Limits to GrowthGrowth stallsRemove or attenuate the limit
Eroding GoalsStandards keep slippingLock in goals; create better feedback
EscalationCompetitive spiralBreak the loop; find win-win
Success to SuccessfulWinners take allDiversify allocation; level playing field

Workflow: Sequencing the Operations

For most founder challenges, follow this workflow:

1. map-system
   ↓
2. archetype-match (see if it's a known pattern)
   ↓
3. find-leverage (identify high-impact interventions)
   ↓
4. trace-effects (anticipate consequences)
   ↓
5. diagnose-delays (check for timing issues)
   ↓
6. Iterate as needed

Shortcut: If it's clearly one of the classic archetypes, you can jump straight to archetype-match, but mapping first is still recommended.

Integration with Other Skills

Strategic Decision

  • Use systems thinking to map the strategic landscape
  • Find leverage points in your business model
  • Trace long-term effects of strategic choices
  • Diagnose why past strategies failed

Principle

  • Extract system principles from your CLDs
  • Use questioning to uncover hidden system structures
  • Challenge mental models (paradigms) that shape your system
  • Document principles for avoiding common archetypes

Product Builder

  • Map your product ecosystem (users, features, metrics)
  • Find leverage in your product roadmap
  • Trace how feature changes affect user behavior
  • Diagnose why product changes aren't working as expected
  • Identify feedback loops in user engagement

Founder-Specific Annotated Examples

Example 1: User Acquisition Oscillation

Symptom: User acquisition goes up when we spend on ads, then crashes right after, even with continued spending.

map-system Output:

Ad Spend → New Users → Churn → (loss of users)
          ↓
    Monthly Active Users (MAU)
          ↓
    Revenue ← Ad Spend (cost)
          ↓
    Profit ↓ → Ad Budget Cuts || → Ad Spend ↓
              (delay: reporting takes 2 weeks)
  • Reinforcing Loop R1: Ad Spend → New Users → Revenue → More Ad Spend
  • Balancing Loop B1: Ad Spend → Cost → Profit ↓ → Budget Cuts → Ad Spend ↓
  • Delay: 2-week reporting delay before budget decisions

archetype-match: Oscillation from delayed feedback

find-leverage:

  • High leverage: Fix the information flow (real-time reporting instead of 2-week delay)
  • Medium leverage: Add a buffer (minimum ad budget floor)
  • Low leverage: Tweak ad targeting parameters

trace-effects of real-time reporting:

  • 1st: See ad performance daily
  • 2nd: Adjust budgets incrementally instead of cutting abruptly
  • 3rd: Avoid MAU crashes
  • 4th: More stable revenue and profit

Outcome: Smoother user growth without wild oscillations


Example 2: Team Burnout Feedback Loop

Symptom: We rush to ship features, team works overtime, burns out, productivity drops, then we rush even more to catch up.

map-system Output:

Deadline Pressure → Overtime → Burnout || → Productivity ↓
     ↑                                       ↓
  Missed Deadlines ← Delivery Delay ← Productivity ↓
  • Reinforcing Loop R1: More pressure → more overtime → more burnout → lower productivity → more pressure...
  • Delay: Burnout takes weeks to manifest and months to recover from

archetype-match: Escalation + Fixes That Fail (the "fix" of overtime makes the problem worse)

find-leverage:

  • Highest leverage: Change the paradigm (move from "ship at all costs" to "sustainable delivery")
  • High leverage: Change the goal (prioritize sustainability over arbitrary deadlines)
  • Medium leverage: Change rules (no more than 10% overtime allowed)

trace-effects of overtime limit:

  • 1st: Some deadlines slip in short term
  • 2nd: Team burnout decreases over 1-2 months
  • 3rd: Productivity stabilizes and actually increases long-term
  • 4th: More predictable delivery, less firefighting

Outcome: Breaking the burnout cycle and building a sustainable team


Example 3: Growth That Stalls (Limits to Growth)

Symptom: We grew fast for 6 months by hiring more salespeople, but now growth is flat even with more hires.

map-system Output:

Hiring → Sales Team Size → New Customers ← Market Saturation ||
     ↑                           ↓
  Revenue ← New Customers → (Market approaches saturation)
  • Reinforcing Loop R1: Hiring → More sales → More revenue → More hiring
  • Balancing Loop B1: New Customers → Market Saturation → Fewer new customers
  • Delay: Market saturation creeps up gradually, hard to notice immediately

archetype-match: Limits to Growth

find-leverage:

  • High leverage: Remove the limit (expand to new markets, new customer segments)
  • Medium leverage: Strengthen the reinforcing loop (increase sales efficiency per rep)
  • Low leverage: Keep hiring more reps (diminishing returns)

trace-effects of expanding to new market:

  • 1st: Initial investment in market research and localization
  • 2nd: New pool of unsaturated customers
  • 3rd: R1 loop re-activates in new market
  • 4th: Growth resumes with a new ceiling

Outcome: Breaking through the growth ceiling by expanding the market

Quick Reference Card

When to Use Which Operation

GoalOperation
Understand what's really going onmap-system
Find where to intervene for max impactfind-leverage
Avoid unintended consequencestrace-effects
Fix oscillations or instabilitydiagnose-delays
Use proven solutions for classic problemsarchetype-match

Quick Archetype Recognition

What You SeeLikely Archetype
Problem keeps coming back worseFixes That Fail
Addicted to quick fixesShifting the Burden
Growth stalls despite effortLimits to Growth
Standards keep slippingEroding Goals
Competitive arms raceEscalation
Rich get richer, poor get poorerSuccess to the Successful

Meadows' Leverage Points (Quick Recap)

  1. Transcend paradigms
  2. Change paradigms
  3. Change goals
  4. Enable self-organization
  5. Change rules
  6. Improve information flows
  7. Adjust reinforcing loop gains
  8. Strengthen balancing loops
  9. Reduce delays
  10. Restructure stocks & flows
  11. Adjust buffer sizes
  12. Tweak numbers

Best Practices

  1. Start Simple: Don't try to map everything at once—focus on the 5-10 most important variables
  2. Use Sticky Notes: Physical or digital sticky notes work great for building CLDs collaboratively
  3. Validate with Stakeholders: Your mental model isn't the only one—get others' perspectives
  4. Look for Loops, Not Lines: Systems are circular, not linear; always search for feedback
  5. Embrace Iteration: Your first CLD will be wrong—update it as you learn more
  6. Go High on Leverage: Don't waste time on parameter tweaks when you could change the paradigm
  7. Expect Delays: Things always take longer than you think—explicitly account for time lags

Common Pitfalls to Avoid

  • Linear Thinking: Assuming "more A = more B" without considering feedback loops
  • Ignoring Delays: Making decisions before effects have time to manifest
  • Focusing on Numbers: Tweaking metrics instead of changing structure
  • Blame Game: Blaming people instead of the system that shapes their behavior
  • Overcomplicating: Including every possible variable instead of focusing on key ones
  • Analysis Paralysis: Mapping forever instead of testing interventions

Maintenance

This skill will evolve as you apply it:

  • CLD Templates: Build industry-specific templates for common founder challenges
  • Archetype Library: Add new archetypes as you discover them in your context
  • Leverage Point Case Studies: Document what actually worked in your startup
  • Delay Database: Track common delays in your business and how to reduce them

"Systems thinking is a discipline for seeing wholes. It is a framework for seeing interrelationships rather than things, for seeing patterns of change rather than static 'snapshots.'" — Peter Senge

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.