unknown
npx skills add https://github.com/team-attention/plugins-for-claude-natives --skill unknown
Agent 安装分布
Skill 文档
Unknown: Surface Blind Spots with Known/Unknown Quadrants
Surface hidden assumptions and blind spots in any strategy, plan, or decision using the Known/Unknown quadrant framework and hypothesis-driven questioning.
When to Use
- Strategy or planning documents that need scrutiny
- Decisions with unclear direction or hidden assumptions
- Any situation where “what we don’t know” matters more than “what we do know”
For specific requirement clarification (feature requests, bug reports), use the vague skill. For content-vs-form reframing (optimizing within a form vs inventing a new form), use the metamedium skill.
Core Principle: Hypothesis-as-Options
ALWAYS use the AskUserQuestion tool for every question in R1/R2/R3 â never ask questions in plain text. The structured format enforces hypothesis-as-options and limits choice fatigue.
Present hypotheses as options instead of open questions. The hypotheses ARE the analysis â by designing good options, 80% of the analytical work is done before the user even answers. The user’s job is to confirm, correct, or surprise.
BAD: "Why can't you do video content?" â open question, high load
GOOD: "Time / Skill gap / No guests / High bar" â pick one or more
- Each option IS a testable hypothesis about the user’s situation
- Use multiSelect: true to catch compound causes
- “Other” is always available for out-of-frame answers
3-Round Depth Pattern
| Round | Purpose | Questions | Key trait |
|---|---|---|---|
| R1 | Validate draft quadrant | 3-4 | Broad, covers all quadrants |
| R2 | Drill into weak spots | 2-3 | Targeted, follows R1 answers |
| R3 | Nail execution details | 2-3 | Specific, optional |
Critical: Generate Round N questions from Round N-1 answers. Never use pre-prepared questions across rounds. Cap total at 7-10 questions.
Protocol
Phase 1: Intake
File provided: Read and extract goals, components, implicit assumptions, missing elements.
Topic keyword only: Start directly with R1 questions to establish scope. The draft in Phase 3 will be rougher but R1 corrects it.
Phase 2: Context
Gather related context to find Unknown Knowns â assets the user may not realize they have:
- Glob for related files: CLAUDE.md, README, decision records, past analyses in the project
- Read project context: recent goals, team structure, active initiatives
- Identify underutilized assets: existing tools/skills not in use, past projects with reusable patterns, team expertise not leveraged
Items discovered here become UK candidates and options in R1 questions.
Phase 3: Draft + R1 Questions
Generate an initial 4-quadrant classification. The draft is intentionally rough â R1 exists to correct it, not confirm it. Err on the side of classifying uncertain items as KU rather than KK.
Design R1 questions to test quadrant boundaries. Batch all R1 questions into a single AskUserQuestion call (max 4 questions):
| Target | Pattern | Example |
|---|---|---|
| KK | “Is this really certain?” | “Primary revenue source?” (options) |
| KU | “Where’s the weakest link?” | “Which flywheel connection is weakest?” |
| UK | “What exists but isn’t used?” | Based on context findings |
| UU | “What’s the biggest fear?” | Risk scenarios as options |
Phase 4: Deepen + R2 Questions
Analyze R1 answers. Find the most uncertain area and drill in.
R2 triggers: compound answers (messy area), unexpected answers (draft wrong), “Other” selected (outside frame).
For detailed R2 question types, see references/question-design.md.
Phase 5: Execute + R3 Questions (Optional)
After priorities are set, nail down execution details for top items. Skip if R2 already provides enough detail.
Phase 6: Playbook Output
Generate a structured 4-quadrant playbook file. For the complete output template, see references/playbook-template.md.
Output structure:
# {Topic}: Known/Unknown Quadrant Analysis
## Current State Diagnosis
## Quadrant Matrix (ASCII with resource %)
## 1. Known Knowns: Systematize (60%)
## 2. Known Unknowns: Design Experiments (25%)
- Each KU: Diagnosis â Experiment â Success Criteria â Deadline â Promotion Condition
## 3. Unknown Knowns: Leverage (10%)
## 4. Unknown Unknowns: Set Up Antennas (5%)
## Strategic Decision: What to Stop
## Execution Roadmap (week-by-week)
## Core Principles (3-5 decision criteria)
Resource percentages (60/25/10/5) are defaults. Adjust based on context â e.g., a startup exploring product-market fit may allocate 40% KU and 30% KK.
Anti-Patterns
- Open questions (“What would you like to do?”) â use hypothesis options
- 5+ options per question â causes choice fatigue
- Ignoring R1 answers when designing R2 â performative questioning
- Equal depth on all quadrants â wastes time, loses focus
- No “stop doing” section â adding without subtracting
Example
Input: Growth strategy document
R1: Revenue source? â Workshops. Weakest link? â BizâKnowledge. Blocker? â Skill gap + high bar (multiSelect). Biggest fear? â Execution scattered.
R2 (driven by “execution scattered”): What to drop? â Product dev. Why no knowledgeâcontent? â No process + no time + hard to abstract. Role clarity? â Unclear.
R3: Video format? â Screen recording. Retro blocker? â Don’t know what to capture. What content resonated? â Raw discoveries.
Key discovery: Abstraction isn’t needed â raw insights work better. Collapsed triple bottleneck into 15-minute pipeline.
Rules
- Hypotheses, not questions: Every option is a testable hypothesis
- Answers drive depth: R2 from R1, R3 from R2
- 7-10 questions max: Beyond this is fatigue
- Stop > Start: Always include “what to stop doing”
- Promote or kill: Every KU gets a promotion condition and a kill condition
- Raw > Perfect: Encourage minimum viable experiments, not perfect plans
- Draft is disposable: The initial quadrant is meant to be corrected
Additional Resources
Reference Files
references/question-design.mdâ Detailed question types for each round, trigger conditions, and AskUserQuestion formatting guidereferences/playbook-template.mdâ Complete output template with section-by-section guide