s4h-systems-feedback-mapping

name	s4h-systems-feedback-mapping
description	Identifies all reinforcing (+) and balancing (−) feedback loops in a system. Use when asked to 'map the feedback loops', 'why does this keep happening', 'unintended consequences', or 'system keeps oscillating'.

Systems Feedback Mapping

Most system failures come from unrecognized feedback loops — especially delayed balancing loops that cause overshoot and collapse. Reinforcing loops amplify change in one direction; balancing loops push back toward a target. Until both types are visible and named, diagnosis and intervention are guesswork.

---

Your Process

Step 1: Define System Boundary State what is inside the system and what is outside it. Name the time horizon and the key behavior to explain (growth, oscillation, collapse, stagnation).

Framing check: Confirm the specific system and the feedback relationship in focus before continuing. State what you've identified — the actual system being analyzed, its time horizon, and the behavior you're mapping — in one sentence, then use AskUserQuestion:

• Question: "I'm reading this as: [your one-sentence framing of the system, time horizon, and behavior to explain]. Is that right?"
• Header: "Framing"
• Options:
  • Yes — proceed — framing is correct
  • Adjust — one element is off; user will correct it before you continue
  • Reframe — different situation than read; incorporate the correction before proceeding

Step 2: List Key Variables Identify 5–10 variables that change over time and drive the behavior in question. These are stocks (levels that accumulate) or flows (rates of change). Be specific — "customer trust" not "sentiment".

Before narrowing: Show the complete generated set of candidate variables to the user first. Use AskUserQuestion:

• Question: "I've identified [N] candidate variables. Before I narrow to the 5–10 most relevant for mapping feedback loops, are there any you'd flag as especially important, or any I've missed?"
• Header: "Prioritise"
• Options:
  • Proceed with your selection — the set looks right
  • Flag one — user will name a specific variable to include
  • Add a missing one — user will describe it

Step 3: Map Causal Links For each variable pair where a relationship exists: does A increasing cause B to increase (same direction, +) or decrease (opposite direction, −)? Mark the polarity of each link.

Step 4: Trace Loops Follow causal chains until they close back on themselves. Count the number of negative (−) links in the loop. Even number of negatives = reinforcing loop (R). Odd number = balancing loop (B). Name each loop.

Step 5: Mark Delays Identify where cause is separated from effect in time. Delays are the primary source of oscillation and overshoot — a balancing loop with a long delay will overcorrect.

Step 6: Identify the Dominant Loop Which loop is currently driving system behavior? The dominant loop changes as conditions change — map the transition conditions.

---

Human Check-in

Before proceeding, use the AskUserQuestion tool. State your interpretation of the situation in 1–2 sentences — what is being analyzed and what the core question is — then ask:

• Question: "My read: [your 1–2 sentence interpretation]. How do you want to proceed?"
• Header: "Scope"
• Options:
  • Full analysis — Complete all steps, reasoning shown throughout
  • Key findings only — Bottom-line output, skip step-by-step detail
  • Reinforcing loops only — What's accelerating in this system, skip balancing loops
  • Reframe — The read is off; correct it and the analysis will follow the corrected framing

Proceed based on their selection. If the user reframes, incorporate the correction before running any analysis.

Output Format

System Boundary: [scope + time horizon + behavior to explain]

Feedback Loop Table

Loop Name	Type (R/B)	Variables in Loop	Delay?	Current Strength

Dominant Loop: [name] — [what behavior it produces]

Delay Risks: [which delays are creating overshoot or oscillation]

What This Predicts: [expected system behavior if current structure holds]

---

Notes

Loops are not permanent — the dominant loop shifts as variables hit limits or thresholds. Map the transition condition that would shift dominance from one loop to another.

---

What's Next

After delivering this output, use AskUserQuestion to offer the next move:

• Question: "Feedback loops mapped. What's next?"
• Header: "Next"
• Options:
  • /s4h-systems-leverage-analysis — Find leverage points within the feedback loops
  • /s4h-temporal-cycle-detection — Detect cycles the feedback loops create
  • /s4h-strategy-positioning — Position to exploit or break the key feedback loops
  • Done — Wrap up and synthesise what we have so far