本文へ移動
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

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

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 のスキルをすべて見る

このスキルの問題を報告する