breadth-of-thought
Skill0 starsChanged 33 days agoMITView on GitHub
Maps the whole solution space by exploring 8-10 fundamentally different approaches, pruning only the clearly non-viable, and returning 3-5 viable options with their trade-offs instead of one winner. Use for what are all my options, I do not know what the possibilities are, compare every architecture, or any decision where missing a viable alternative would be costly. Not for picking the single best of known options (use tree-of-thoughts), tracing a long dependent chain of reasoning (use self-reflecting-chain), diagnosing a bug or incident (use hypothesis-elimination), or obvious one-path problems.
In this repository15 other files it gives its agents.
- .claude/CLAUDE.mdCLAUDE.md
- adversarial-reasoningSkill
- analogical-transferSkill
- dialectical-reasoningSkill
- hypothesis-eliminationSkill
- integrated-reasoningSkill
- negotiated-decision-frameworkSkill
- option-synthesisSkill
- parallel-executionSkill
- premortem-evolvedSkill
- rapid-triage-reasoningSkill
- reasoning-handover-protocolSkill
- self-reflecting-chainSkill
- skill-gauntletSkill
- tree-of-thoughtsSkill
The file
We split this skill into the rules it gives an agent
12 rules. About 0 are common, 12 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈12
Distinctive · estimate
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 107
Document trade-offs and assumptions
- Distinctive: line 147
Hybrid: Use Task for complex approaches, sequential for simpler ones
- Distinctive: line 168
No mitigating strategies possible
- Distinctive: line 201
(Optional) Level 2: If more depth is needed, repeat for the top 5 branches (5 sub-approaches each, up to 25 more)
- Distinctive: line 236
After Level 1: If you have 10-15 viable sub-approaches (sufficient breadth)
- Distinctive: line 237
Continue to Level 2: If approaches still too abstract, need implementation details
- Distinctive: line 327
Wait for completion, evaluate, prune
- Distinctive: line 340
After applying BoT methodology, verify:
- Distinctive: line 360
Ignoring Unknown Unknowns: Not exploring "wild card" unconventional approaches
- Distinctive: line 377
If you're asking "What are ALL my options?", use Breadth of Thought
- Distinctive: line 378
If you're asking "Which option is BEST?", use Tree of Thoughts
- Distinctive: line 404
Use it when you need comprehensive exploration and can't afford to miss viable alternatives.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Effort & Thinking Budget
- Recommended effort: high — exhaustive exploration needs depth to avoid shallow analysis
- Include "ultrathink" in complex analysis phases to enable extended thinking
- For time-constrained scenarios, use effort: medium with reduced branch count (5 approaches instead of 8-10)
Model Recommendation
Best with Opus for maximum reasoning depth. On Sonnet, reduce to 5 approaches per level to maintain analysis quality.
Breadth of Thought Reasoning Methodology
Purpose: Exhaustive exploration of solution spaces through systematic parallel breadth-first reasoning. Maintains multiple hypotheses, explores diverse approaches, and returns 3-5 viable solutions instead of prematurely converging on one.
When to Use Breadth of Thought
✅ Use BoT when:
- Unknown solution space (you don't know what you don't know)
- Multiple valid solutions needed (need 3-5 good options, not just 1 best)
- High-stakes decisions (can't afford to miss viable alternatives)
- Novel problems (no clear best practice exists)
- Debugging complex issues (multiple potential root causes)
- Comprehensive planning (need to evaluate ALL options before deciding)
❌ Don't use BoT when:
- Clear evaluation criteria exist and you need THE single best solution → Use tree-of-thoughts
- Problem requires deep sequential reasoning with dependencies → Use self-reflecting-chain
- Single obvious approach exists → Solve directly
- Time-critical with simple trade-offs → Quick analysis sufficient
Examples:
- "Redesign data pipeline: batch, streaming, hybrid, or other?" (unknown space) ✅
- "System crashes intermittently: network, DB, memory, race, or config?" (multiple causes) ✅
- "Choose caching strategy: write-through, eventual, hybrid?" (clear criteria - use ToT) ❌
- "Fix syntax error" (obvious solution) ❌
Breadth vs Depth Comparison
| Dimension | Breadth of Thought | Tree of Thoughts |
| Exploration | Wide: 8-10 approaches at Level 0, 5 sub-approaches per retained approach below | Deep: 5 branches → 1 best |
| Pruning | Conservative: Keep >40% | Aggressive: Keep top 1-2 |
| Levels | Shallow: 2-3 levels | Deep: 4-6 levels |
| Output | 3-5 viable solutions | 1 optimal solution |
| Use when | Solution space unknown | Evaluation criteria clear |
| Total exploration | 33-45 branches (up to 70 with Level 2) | 20-30 branches |
| Philosophy | "Don't miss anything" | "Find the best" |
Core Methodology: 4-Step Process
Step 1: Solution Space Mapping (8-10 Approaches)
Objective: Identify 8-10 fundamentally distinct approaches
Actions:
- Analyze problem from multiple perspectives:
- Technical: Different technologies, architectures, patterns
- Business: Different cost models, value propositions
- Organizational: Different team structures, processes
- Risk: Conservative vs innovative approaches
- Timeline: Quick wins vs long-term solutions
- Generate 8-10 distinct approaches (not variations)
- For each approach, create brief description and viability estimate
- Do NOT prune yet - explore all in parallel
Approach Diversity Requirement:
- ❌ Variations: "Use PostgreSQL" vs "Use MySQL" (both relational)
- ✅ Distinct: "Relational DB" vs "Document store" vs "Event sourcing" vs "In-memory cache"
Example (Data Pipeline):
1. **Batch processing** (traditional ETL)
2. **Real-time streaming** (Kafka/Flink)
3. **Micro-batch** (Spark Structured Streaming)
4. **Lambda architecture** (batch + stream hybrid)
5. **Kappa architecture** (stream-only)
6. **Event sourcing** (immutable log)
7. **Change data capture** (DB triggers)
8. **Serverless functions** (FaaS on events)Deliverable: 8-10 distinct approaches ready for parallel exploration
Step 2: Level 0 Breadth Exploration (Parallel)
Objective: Explore EACH approach in depth with self-reflection
For each of 8-10 approaches:
- Research the approach comprehensively
- Analyze strengths, weaknesses, constraints
- Identify use cases where it excels vs struggles
- Estimate feasibility, complexity, risk
- Rate confidence (0-100%) in viability
- Document trade-offs and assumptions
Exploration Template (per approach):
## Approach [N]: [Name]
### Overview
[2-3 sentence description]
### Strengths
- [Strength 1]
- [Strength 2]
- [Strength 3]
### Weaknesses
- [Weakness 1]
- [Weakness 2]
- [Weakness 3]
### Use Cases
- **Excels when**: [Scenario where this is optimal]
- **Struggles when**: [Scenario where this is problematic]
### Feasibility Assessment
- **Technical**: [Complexity, maturity, team expertise]
- **Operational**: [Maintenance, monitoring, scaling]
- **Business**: [Cost, time-to-market, ROI]
### Confidence: [0-100]%
**Rationale**: [Why this confidence level]
### Key Assumptions
- [Assumption 1]
- [Assumption 2]Execution Options:
- With Task tool: Spawn 8-10 parallel tasks for independent exploration
- Without Task tool: Explore sequentially, using TodoWrite to track progress
- Hybrid: Use Task for complex approaches, sequential for simpler ones
Deliverable: 8-10 explored approaches with confidence scores
Step 3: Conservative Pruning (Keep >40%)
Objective: Evaluate all branches and prune ONLY the clearly non-viable
Pruning Philosophy: Breadth of Thought is conservative - we keep branches that might work, even if not optimal. Only prune if confidence <40% AND fatal blocker exists.
Actions:
- Review all Level 0 explorations
- Score each approach:
- Feasibility: Technical, operational, business viability
- Completeness: How thoroughly was it explored?
- Risk vs Reward: What's the upside/downside balance?
- Prune ONLY if:
- Confidence <40% AND
- Fatal technical blocker identified AND
- No mitigating strategies possible
- For retained branches (typically 5-7), document why kept
- Rank retained branches for Level 1 expansion
Pruning Examples:
✅ Keep (50% confidence):
- Approach is technically feasible but has implementation challenges
- Team lacks expertise but can hire/learn
- Cost is high but ROI justifies it
- Reason: Viable with mitigation, worth exploring deeper
❌ Prune (35% confidence):
- Approach requires technology that doesn't exist yet
- Violates hard constraint (e.g., regulatory compliance impossible)
- Cost exceeds budget by 10x with no path to reduce
- Reason: Fundamentally not viable, no mitigating strategies
Typical Outcome: Prune 2-3 approaches, retain 5-7 for Level 1
Deliverable: 5-7 retained approaches ranked by viability
Step 4: Level 1+ Expansion (5 Sub-Approaches Each)
Objective: For each retained approach, explore 5 variations/implementations
Actions:
- Take each of the 5-7 retained approaches from Step 3
- For each approach, identify 5 sub-approaches (variations, implementations, configurations)
- Explore each sub-approach (same depth as Level 0)
- Evaluate and prune conservatively (keep >40%)
- (Optional) Level 2: If more depth is needed, repeat for the top 5 branches (5 sub-approaches each, up to 25 more)
Level 1 Decomposition (per retained approach):
## Level 1: Expanding Approach [N]
### Sub-Approach [N].1: [Variation 1]
[Exploration...]
### Sub-Approach [N].2: [Variation 2]
[Exploration...]
### Sub-Approach [N].3: [Variation 3]
[Exploration...]
### Sub-Approach [N].4: [Variation 4]
[Exploration...]
### Sub-Approach [N].5: [Variation 5]
[Exploration...]Example (Expanding "Real-time Streaming"):
Approach 2: Real-time Streaming
├─ 2.1: Kafka + Flink
├─ 2.2: Kafka + Spark Streaming
├─ 2.3: AWS Kinesis + Lambda
├─ 2.4: Pulsar + custom processors
└─ 2.5: Redis Streams + Node.js workersBranch count: 8-10 at Level 0, plus 5-7 retained × 5 = 25-35 at Level 1, so 33-45 branches through Level 1. Level 2 adds at most 25 (top 5 × 5), for 70 at most.
Stopping Criteria:
- After Level 1: If you have 10-15 viable sub-approaches (sufficient breadth)
- Continue to Level 2: If approaches still too abstract, need implementation details
- Maximum Depth: 3 levels, Level 0 to Level 2 (breadth over depth philosophy)
Deliverable: 10-15 viable solutions across all expanded approaches
Final Synthesis: Return Top 3-5 Solutions
Objective: Synthesize exploration into actionable recommendations
Actions:
- Review ALL explored branches (Level 0 + Level 1 + Level 2)
- Identify top 10-15 branches by confidence score
- Group similar approaches together
- Select top 3-5 distinct solutions representing different trade-off profiles
- For each selected solution, document:
- Full path (e.g., Approach 2 → Sub-approach 2.3)
- Confidence score and rationale
- Key strengths and weaknesses
- Best use case
- Implementation considerations
Synthesis Template:
## Breadth of Thought Analysis Complete
### Total Exploration
- **Level 0**: 8 approaches explored → 6 retained
- **Level 1**: 30 sub-approaches explored (6 × 5) → 12 retained
- **Total branches analyzed**: 38 (8 + 30)
- **Time**: [X] minutes
### Top 5 Viable Solutions
#### Solution 1: [Name] (Confidence: [X]%)
- **Path**: Approach [N] → Sub-approach [N.M]
- **Best for**: [Use case where this excels]
- **Strengths**: [Key strengths]
- **Weaknesses**: [Key weaknesses]
- **Implementation**: [Complexity, timeline, resources]
#### Solution 2: [Name] (Confidence: [X]%)
[Same structure...]
#### Solution 3: [Name] (Confidence: [X]%)
[Same structure...]
#### Solution 4: [Name] (Confidence: [X]%)
[Same structure...]
#### Solution 5: [Name] (Confidence: [X]%)
[Same structure...]
### Trade-Off Analysis
**If you prioritize [X]**, choose **Solution [N]**
**If you prioritize [Y]**, choose **Solution [M]**
**If you prioritize [Z]**, choose **Solution [P]**
### Recommendation
Based on [stated priorities/constraints], I recommend:
1. **Primary**: Solution [N] ([X]% confidence)
2. **Alternative**: Solution [M] ([X]% confidence) if [condition]
3. **Backup**: Solution [P] ([X]% confidence) if [condition]
### Branches Not Explored
Due to time/scope constraints, the following were not explored:
- [Potential approach 1]
- [Potential approach 2]
These could be investigated if none of the top 5 solutions work out.Deliverable: 3-5 viable solutions with clear trade-off analysis
Resource Management
Time Budget (if resource-constrained):
- Level 0: 15-20 minutes (8-10 approaches)
- Level 1: 20-30 minutes (5-7 approaches × 5 sub-approaches)
- Level 2: 15-20 minutes (optional, if time allows)
- Total: 50-70 minutes maximum
Batch Execution (with Task tool):
- Spawn Level 0 tasks in single batch (8-10 tasks)
- Wait for completion, evaluate, prune
- Spawn Level 1 tasks in batches of 10-15
- Monitor time, stop spawning if approaching limit
Early Termination (if time runs out):
- Evaluate completed branches only
- Return partial results with note about incomplete exploration
- State confidence level based on partial coverage
Self-Critique Checklist
After applying BoT methodology, verify:
- Sufficient Breadth: Did I explore 8-10 approaches at Level 0?
- Approach Diversity: Are approaches fundamentally different (not variations)?
- Conservative Pruning: Did I keep all branches >40% confidence?
- Depth Per Branch: Did each branch get thorough exploration (not surface-level)?
- Multiple Solutions: Am I returning 3-5 solutions (not just 1 "best")?
- Trade-Off Clarity: Can user choose based on their priorities?
- Confidence Validity: Are confidence scores justified by exploration depth?
- Completeness: Did I explore enough to confidently say "I didn't miss anything major"?
Common Mistakes to Avoid
- Premature Pruning: Cutting branches at 50-60% confidence instead of <40%
- Depth Over Breadth: Going 5 levels deep on 2 approaches instead of 2 levels on 8 approaches
- Variation vs Diversity: Exploring PostgreSQL, MySQL, MariaDB as "3 approaches" (all relational)
- Single Winner: Returning only 1 solution like ToT, defeating purpose of BoT
- Shallow Exploration: Brief 1-paragraph analyses instead of thorough investigation
- Ignoring Unknown Unknowns: Not exploring "wild card" unconventional approaches
- Over-Execution: Going to Level 2 when Level 1 already gave 10-15 viable solutions
Breadth-First vs Depth-First Decision Guide
| Problem Characteristic | Use BoT (Breadth) | Use ToT (Depth) |
| Solution space | Unknown, unexplored | Well-understood |
| Output needed | Multiple options | Single best |
| Evaluation criteria | Unclear or multiple | Clear and agreed |
| Risk tolerance | Can't miss alternatives | Can commit to best |
| Problem novelty | Novel/unprecedented | Has precedents |
| Time available | Moderate (1 hour) | Flexible (2+ hours) |
Rule of thumb:
- If you're asking "What are ALL my options?", use Breadth of Thought
- If you're asking "Which option is BEST?", use Tree of Thoughts
Reference Documentation
Detailed Templates: references/breadth-of-thought-advanced-patterns.md
Includes:
- Approach exploration template (deep-dive structure)
- Conservative pruning guidelines (when to keep vs cut)
- Level transition logic (when to go to Level 2)
- Trade-off analysis framework
- Edge case handling (convergence, insufficient diversity)
Summary
Breadth of Thought is a systematic methodology for exhaustive solution space exploration through:
- Wide branching (8-10 approaches at Level 0, 5 sub-approaches per retained approach)
- Conservative pruning (keep >40% confidence)
- Shallow depth (2-3 levels maximum)
- Multiple solutions (return top 3-5, not just 1)
- Trade-off analysis (help user choose based on priorities)
Use it when you need comprehensive exploration and can't afford to miss viable alternatives. The goal is thorough coverage of solution space, not finding a single optimal answer.
Remember: Breadth of Thought trades depth for coverage. You'll explore more branches but less deeply than Tree of Thoughts. Perfect for "What are my options?" questions, not "Which option is best?" questions.
Backstage rule — the method never appears in the answer
This methodology is scaffolding, not content. In the user-facing answer: no method names ("Breadth of Thought", "BoT", or any other pattern name), no method narration ("applying the method", "scoring the dimensions", "this branch scores 7/10"), no internal scores or affinity arithmetic, no confidence-aggregation or checkpoint talk. Structure earns its place only as content built from the problem's own facts — a hypothesis table in a diagnosis, an options-vs-criteria matrix in a selection — never as a display of process. Before delivering, run a literal text search over the answer for the names above and for "pattern", "branch", "affinity", "dimension score", "confidence aggregation", "checkpoint"; rewrite every hit as content or delete it. The reader sees findings, not the apparatus that produced them.
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.

