본문으로 건너뛰기
cccskills
무료GitHub에 공개

assumption-mapping

Surface every assumption embedded in a plan, strategy, or document, assess how critical and how validated each one is, and identify which ones to test first. Load when the user asks to map assumptions, surface hidden beliefs, find what must be true for this to work, run an assumption audit, or when deep-thinking diagnoses an assumption frame. Also triggers on "what are we assuming", "what must be true for this to work", or "find the untested beliefs". Based on David Bland and Alex Osterwalder's assumption mapping method from Testing Business Ideas.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

설치 방법 보기

포함된 파일(2)

  • SKILL.md7.6 KB
  • references/examples.md2.9 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

Assumption Mapping

You are an assumption auditor. You make implicit beliefs explicit, assess their risk, and produce a prioritised list of what to test — so the team runs experiments on what matters, not what is easy.

Hard Rules

State assumptions as falsifiable claims. "Users want this" is not an assumption. "Users will pay $20/month for this feature" is — it can be tested and proven false.

Assumptions are not risks. A risk is an event that might happen. An assumption is a belief that must be true for the plan to work. Keep them separate.

The most dangerous assumptions are the most confident ones. Teams rarely test what they're sure of. That's where surprises come from.

Skip this if: Skip if: the plan has only 1–2 assumptions and they are obvious. Skip if: the user just needs to start and can course-correct. Use only when many unvalidated beliefs are embedded in a plan.


The Assumption Grid

Two axes:

  • Importance: if this assumption is wrong, does the whole plan fail, or just a part of it?
  • Evidence: how much real evidence (user data, market data, precedent) do we have that this is true?
               LOW EVIDENCE    HIGH EVIDENCE
HIGH IMPORTANCE  [CRITICAL]       [VALIDATED]
LOW IMPORTANCE   [MONITOR]        [DEPRIORITISE]

Critical = test these first, they can kill everything Validated = these are solid, build on them Monitor = worth watching, not urgent Deprioritise = don't spend energy here


Workflow

Step 1 — Read the Plan or Document

Extract all embedded assumptions. Look in:

  • Goal statements ("users will do X")
  • Success metrics ("we expect Y% conversion")
  • Strategy claims ("we are better than X because...")
  • GTM claims ("users will find us via...")
  • Team/resource claims ("this will take 2 weeks")

Step 2 — State Each as a Falsifiable Claim

Convert implicit beliefs to explicit, testable statements:

  • Vague: "our users are frustrated with current tools"
  • Explicit: "70% of our target users have tried at least 2 competing tools and abandoned them"

Step 3 — Place Each on the Grid

Ask for each assumption:

  • Importance: If this is false, does the core plan fail? (High/Low)
  • Evidence: What real data, research, or tested precedent do we have? (High/Low)

Step 4 — Prioritise the Critical Zone

For every assumption in the Critical quadrant (high importance, low evidence):

  • What is the minimum experiment that would test this?
  • What would "proven false" look like — specifically?
  • What would "proven true" look like?

Step 5 — Deliver

Assumption Map: [plan/document]

CRITICAL — test these first
┌─────────────────────────────────────────────────┐
│ [Assumption stated as falsifiable claim]         │
│ Evidence we have: [what exists, if anything]     │
│ Minimum test: [cheapest way to validate]         │
│ False condition: [what would disprove it]        │
└─────────────────────────────────────────────────┘

VALIDATED — solid foundations
- [Assumption]: [evidence that supports it]

MONITOR — watch but don't test yet
- [Assumption]: [why it's lower priority]

TOTAL: N assumptions | Critical: N | Validated: N

Gotchas

  • Teams tend to list risks when asked for assumptions. If it starts with "what if..." it's a risk. If it starts with "we believe..." or "this requires..." it's an assumption.
  • The most important assumptions are usually in the demand layer: "people want this", "people will pay for this", "people will tell others about this." Test demand before supply.
  • Don't map more than 15 assumptions at once. It becomes noise. Focus on the top 5 critical ones.

Example

<examples> <example> <input>Map the assumptions in our community feature plan</input> <output> Assumption Map: Community Feature Plan

CRITICAL — test first ┌───────────────────────────────────────────── │ "Users want to connect with each other, not just the product" │ Evidence: 0 — no user research conducted on peer connection desire │ Minimum test: Interview 10 active users. Ask: "When was the last time you wanted to talk to another user of this product?" If fewer than 5 have a real story, assumption is likely false. │ False condition: <30% of users can name a specific thing they'd ask another user └───────────────────────────────────────────── ┌───────────────────────────────────────────── │ "Founding members will sustain posting for 90+ days without incentive" │ Evidence: None — no precedent in this user base │ Minimum test: Ask 5 prospective founding members to commit to 2 posts/week for 4 weeks before launch. See who follows through. │ False condition: Fewer than 3 of 5 complete the 4-week pilot └─────────────────────────────────────────────

VALIDATED

  • "Users are active in the product at least monthly": confirmed by usage data (68% MAU)

MONITOR

  • "Community content will appear in search results": plausible, not yet tested

TOTAL: 8 assumptions found | Critical: 2 | Validated: 1 | Monitor: 5 </output> </example> </examples>


Common Rationalizations

ExcuseReality
"Assumptions are obvious"Obvious to you ≠ validated in market or code.
"We'll validate later"Unmapped assumptions become silent blockers.
"Too many assumptions to list"Prioritize top 5 load-bearing ones first.
"Mapping is bureaucracy"One page prevents weeks of building on sand.
"Users told us what they want"Stated wants often mask unstated constraints.

Verification

  • Load-bearing assumptions separated from nice-to-haves
  • Each critical assumption has a validation method and owner
  • Riskiest assumption identified explicitly
  • Output is actionable this week, not theoretical

Red Flags

  • Risks listed instead of testable assumptions
  • Demand-layer assumptions skipped for tech-heavy ideas
  • More than 15 assumptions mapped in one pass
  • Assumption has no linked validation or kill criterion

Prune Log

Last pruned: 2026-07-04

  • No changes — citation audit passed; content current (improve-skills full pass 2026-07-04)

Impact Report

Assumption map: [plan/document]
Total assumptions surfaced: N
Critical (high importance, low evidence): N
Validated: N | Monitor: N | Deprioritised: N
Minimum experiments defined: N

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

Put on the adversarial hat and systematically attack any document, plan, strategy, or idea to expose its weakest points before commitment. Structured devil's advocate with red team rigour — not pessimism, but evidence-based critique across three phases: diagnostic (are claims accurate?), creative (is the problem artificially constrained?), challenge (are solutions robust?). Load when the user asks to stress test a document, red team this plan, poke holes in this, devil's advocate this, challenge my assumptions, or when product-soul, brainstorming, prd-writing, or inversion calls for adversarial review. Also triggers on "what am I missing", "what could kill this", "find the flaws", or "critique this rigorously".

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

dvy1987/agent-loom32026년 8월 8일 업데이트

Design execution structure for decomposed processes: single agent or multi-agent topology. Load when user says "design an agent for this", "what agent structure do I need", "architect this", "should this be multi-agent", "what's the right execution structure", "agent topology", "how should agents be organized". Takes process-decomposer output as primary input. If triggered directly without a process entry, calls process-decomposer first.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

dvy1987/agent-loom32026년 8월 8일 업데이트

Internal skill. Called by setup-evaluation after a PASS. Launches agents from a validated architecture spec using Claude Code / Ampcode native parallelism (Task tool). Does NOT generate scripts or SDK code — it outputs structured spawn instructions that the platform executes natively. Never invoked directly by the user. Never launches without a setup-evaluation PASS.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

dvy1987/agent-loom32026년 8월 8일 업데이트

Sync library skills from an agent-loom upstream repo into this project's .agents/skills while preserving project-local and forked skills. Load when the user asks to sync agent-loom, update skills from upstream, rsync from ../agent-loom, pull new library skills, upgrade installed skills, or refresh the .agents folder without losing custom project skills. Also triggers on "sync skills from agent-loom", "update my agent skills", "pull skill library updates", or "merge agent-loom improvements into this repo".

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

dvy1987/agent-loom32026년 8월 8일 업데이트

Instrument a shipped product's AI agents with tracing and observability so you can see what they did, why outputs happened, and what each run cost. Plain-language primer plus free-tier-first backend selection (Langfuse, Phoenix, LangSmith, Braintrust) and OpenTelemetry/OpenInference instrumentation. Load when the user asks to add observability, add tracing, instrument my agents, see what my agent is doing in production, set up Langfuse or Phoenix or LangSmith, debug why my agent gave a bad answer, or track LLM cost per request. Also fires when agent-system-architecture or setup-evaluation requires an observability plan for an agent-chain product. NOT for tracing the coding agent itself — that is run-trace. Precondition for runtime-learning-loop.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

dvy1987/agent-loom32026년 8월 8일 업데이트

Run a structured retrospective after development-phase runs of your product's agents — interview the owner in plain language about what went well and poorly, draft ranked improvement hypotheses, then design and run small n=1/n=2 experiments with pre-declared success criteria, guardrails, stop conditions, and a cost/ROI kill-switch. Load when the user says how did that run go, retro this run, the agent output was bad, what should we improve, draft hypotheses, run a small experiment, or after repeated dev runs of an agentic system produce uneven quality. Priority: output quality over performance over cost, each with diminishing-returns stops. NOT a product A/B test (experimentation), NOT coding-agent harness repair (harness-evolution), NOT production-scale learning (runtime-learning-loop).

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

dvy1987/agent-loom32026년 8월 8일 업데이트

dvy1987의 스킬 모두 보기

이 스킬의 문제 신고