Install
openclaw skills install @deciqai/cynefinActivate when: 'our best practices keep failing', 'experts disagree on the right answer', 'the old playbook isn't working', 'we're in crisis and don't know what to do first', 'best practice doesn't apply here', 'we need a different approach'. Do NOT activate when: situation is unambiguously routine (execution only); a specialized tool (OODA, expected value) already fits.
openclaw skills install @deciqai/cynefinCynefin (pronounced "kuh-NEV-in"; Welsh for "habitat") is a sense-making framework by Dave Snowden (IBM, 1999). Its claim: the right decision approach depends on which of five domains the situation falls into — Clear (obvious cause-effect, use SOP), Complicated (knowable with expertise, use analysis), Complex (emergent, probe first), Chaotic (absent cause-effect, act first), Confused (unknown domain, decompose first). The most common and costly error: treating Complex problems as Complicated.
Composes with ooda-loop, feedback-loops, antifragile, first-principles.
Not when: domain is unambiguously Clear (execution only); small-stakes one-shot; specialized framework already fits.
Engine mode: concrete case → run The Process. Coach mode: unfamiliar → guide step by step. In Coach mode, respond one step at a time. Each [WAIT] is a hard stop — output only that step's question, then stop.
[WAIT — do not advance until user responds]
[WAIT — do not advance until user responds]
[WAIT — do not advance until user responds]
Step 1 — Describe: Decision/situation: | Current approach: | What worked/not: | Stakeholders:
Obvious to everyone? (Clear) | Knowable with expertise? (Complicated)
Only retrospective? (Complex) | Absent/in flux? (Chaotic) | Unknown? (Confused)
Diagnostics: 5 experts converge? (Yes → Complicated; No → Complex). Standard best practice works? (Yes → Clear/Complicated; No → Complex/Chaotic). Interventions predictable? (Yes → Clear/Complicated; No → Complex/Chaotic).
Clear: Sense→Categorize→Respond (SOP/automate) | Complicated: Sense→Analyze→Respond (experts)
Complex: Probe→Sense→Respond (safe-to-fail experiments, amplify wins)
Chaotic: Act→Sense→Respond (establish order, then re-classify) | Confused: decompose, classify each part
Domain shifted? (Complicated→Complex from disruption? Clear-Chaotic cliff approaching?)
Clear: deploy SOP; monitor. Complicated: experts; pick defensible alternative.
Complex: parallel safe-to-fail probes; amplify wins. Chaotic: decisive action; re-diagnose.
Boundary watch: shift signals | who monitors | re-diagnosis schedule
Output template:
Cynefin Diagnosis: <situation>
Domain: [Clear/Complicated/Complex/Chaotic/Confused] | Evidence: [cause-effect, expert agreement]
Method: [S-C-R / S-A-R / P-S-R / A-S-R] | Actions: | Mismatch cost (if any):
Boundary watch: [shift signals | monitoring owner | re-diagnosis schedule]
→ Method in Action: Snowden at IBM (1999) and the HBR Synthesis (2007)
| Domain | Examples | Method | Mistake |
|---|---|---|---|
| Clear | Routine compliance; manufacturing QC | S→Categorize→R; SOP | Over-analysis |
| Complicated | Engineering design; surgery; M&A | S→Analyze→R; experts | Analysis paralysis |
| Complex | Startup PMF; org culture; new market entry | Probe→S→R; safe-to-fail | Over-planning |
| Chaotic | Crisis first 24h; security breach | Act→S→R; decisive action | Deliberating |
| Confused | New market; leadership transition | Decompose; classify each | Defaulting to home domain |
→ Primary sources: references/sources.md
[D] = designed upfront | [O] = observed in real use. [O] entries are more valuable.
| Fake move | Reality |
|---|---|
| [D] "We just need a better plan" | Often the issue is Complex — no plan works; probes and adaptation required. |
| [D] "Get me an expert" | Right for Complicated. Wrong for Complex: experts disagree because cause-effect is emergent. |
| [D] "Do what worked last time" | Right for Clear. Dangerous near Clear-Chaotic boundary — produces the cliff fall. |
| [D] "We need more data" | Often a deflection in Complex/Chaotic where data only emerges from probes/action. |
| [D] "The plan is right; execution is the problem" | Classic post-mortem rationalization when Complicated-domain plan failed on Complex-domain problem. |
| [D] "Best practices from industry X" | Only transfers if industry X has the same domain structure. Complex ≠ Complicated. |
| [D] "We need more analysis / more decisiveness" | Analysis: right for Complicated, wrong for Complex/Chaotic. Decisiveness: right for Chaotic, wrong for Complex. |
| → Add [O] entries here after each real use — paste the actual failure pattern | What went wrong and why |
Part of deciqAI Knowledge Skills — open-source thinking skills that make rigor executable for AI agents. Built by deciqAI · https://deciqai.com · Contributions welcome — see the template at the repo root.