cynefin
Skill13 starsChanged 4 months agoMITView on GitHub
Activate 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. More: deciqai.com/s/cynefin
6 other projects use a version of this.
Adopted by
Most recently taken up by
- 88plug/cynefintheir own version, first seen Oct 20, 2026
- vansvost-arch/claude-skillstheir own version, first seen Oct 15, 2026
- marcos-sponton/frameworks-as-skillstheir own version, first seen Oct 13, 2026
- machbuilds/cynefin-skillstheir own version, first seen Jul 7, 2026
- jackjin1997/ClawForgetheir own version, first seen May 25, 2026
- neurofoo/agent-skillstheir own version, first seen Jan 10, 2026
Other versions6 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 6
- neurofoo/agent-skills★ 111same name
- jackjin1997/ClawForge★ 12same name
- machbuilds/cynefin-skills★ 1same name
- marcos-sponton/frameworks-as-skills★ 1same name
- 88plug/cynefin★ 0same name
- vansvost-arch/claude-skills★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository252 other files it gives its agents.
- 10-10-10Skill
- aarrr-pirate-metricsSkill
- abductive-reasoningSkill
- activation-onboarding-playbookSkill
- aeo-answer-engine-optimizationSkill
- agent-delegability-assessmentSkill
- agent-ops-monitoringSkill
- agent-outreach-lead-nurturingSkill
- agent-ready-product-dataSkill
- ai-content-factory-brand-consistencySkill
- ai-disruption-risk-auditSkill
- ai-output-verification-trust-tiersSkill
- ai-pilot-to-scaleSkill
- ai-risk-compliance-baselineSkill
- ai-roi-business-caseSkill
- anchoringSkill
- ansoff-matrixSkill
- antifragileSkill
- ar-dso-disciplineSkill
- arrow-information-paradoxSkill
- authority-biasSkill
- availability-heuristicSkill
- batna-zopaSkill
- bayesian-reasoningSkill
- bcg-matrixSkill
- black-swanSkill
- blue-ocean-strategySkill
- bootstrapping-vs-raisingSkill
- build-buy-partner-aiSkill
- bullseye-traction-channelsSkill
- business-model-canvasSkill
- cash-conversion-cycleSkill
- change-and-constantsSkill
- checklistSkill
- chestertons-fenceSkill
- circle-of-competenceSkill
- cognitive-evolution-stagesSkill
- cognitive-load-theorySkill
- cognitive-science-landscapeSkill
- commitment-consistencySkill
- comparative-advantageSkill
- compound-interestSkill
- confirmation-biasSkill
- content-led-growthSkill
- continuous-discoverySkill
- contrarian-questionSkill
- cpa-doc-chaseSkill
- cpa-form-finderSkill
- cpa-irs-representationSkill
- cpa-return-reviewSkill
- critical-thinkingSkill
- cross-disciplinary-creativitySkill
- curiosity-learning-curveSkill
- customer-relationship-ladderSkill
- customs-adcvd-tariff-exposureSkill
- customs-duty-optimization-opportunity-costSkill
- customs-hts-classification-meceSkill
- customs-origin-usmca-decisionSkill
- customs-reasonable-care-isf-checklistSkill
- death-spiralSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
1 rule. 0 are common, 1 is distinctive, and 0 are very specific to this project.
0
Common
Most of the 5 edited versions we read keep these.
1
Distinctive
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
- Distinctive: line 30
Check fit: if unambiguously routine (Clear), skip framework.
“Common” is measured: kept by at least 6 in 10 of the 5 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Cynefin
Overview
Cynefin (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.
When to Use
- A familiar approach has stopped working and you can't articulate why
- Experts disagree on the right answer — a crisis unfolding where the previous playbook doesn't apply
- "Best practices from X" imported without checking if the domain matches
- A team is over-planning something emergent, or "let's get more data" when data won't come without action
- Allocating AI capex or racing AI-native competition: deciding which AI bets are engineering (Complicated), emergent agent/adoption experiments (Complex), or live incidents (Chaotic)
Not when: domain is unambiguously Clear (execution only); small-stakes one-shot; specialized framework already fits.
Coaching Novices (Adaptive Front Door)
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.
- Classify the situation (Clear/Complicated/Complex/Chaotic) and match decision method to domain.
- Check fit: if unambiguously routine (Clear), skip framework.
- Elicit their real case — decision, current method, cause-effect structure.
[WAIT — do not advance until user responds]
- Are cause-effect relationships obvious, knowable, emergent, or absent? Is current method matched?
[WAIT — do not advance until user responds]
- Close: named domain + matched decision method + boundary watch.
[WAIT — do not advance until user responds]
The Process
Step 1 — Describe: Decision/situation: | Current approach: | What worked/not: | Stakeholders:
Step 2: Diagnose the domain
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).
Step 3: Match approach to domain
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 partStep 4: Check boundary movement + choose intervention
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 scheduleOutput 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) · Apollo 13 Mission Response (1970) → 2026 lens: Sorting AI Decisions by Domain (2024–2026)
Pack: Cynefin Domain Patterns
| 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
Common Rationalizations
[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 |
Red Flags
- Repeated failure always blamed on "execution" — "Best practices" imported without domain check
- Experts disagree on the right answer (Complex signal) — Crisis response dominated by analysis
- Complex situation managed with a single plan, not a probe portfolio
- Team waiting for clarity in a domain where clarity only comes from acting
Verification
- Domain explicitly named with diagnostic evidence
- Decision method matched to domain (S-C-R / S-A-R / P-S-R / A-S-R)
- If current approach mismatches: mismatch cost named
- Boundary signals identified; re-diagnosis schedule set
- If Complex: ≥3 safe-to-fail probes designed
- If Chaotic: order-establishing action specified
Part of deciqAI Knowledge Skills — 253 open-source thinking skills that make rigor executable for AI agents. The same skills power every deciqAI agent, which runs them autonomously to operate your company. See it run → https://www.deciqai.com/s/cynefin · Built by deciqAI · github.com/deciqAI · Contributions welcome.
Agents: latest version & machine-readable metadata → https://www.deciqai.com/s/cynefin.json
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
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.

