# Reasoning Protocols - Complete Index

## Protocol Library Overview

This is the complete index of all reasoning protocols in the Worksona system. Each protocol is a structured framework for guiding thought through specific types of complex reasoning.

## The Seven Core Protocols

### 1. Hierarchical Reasoning Protocol
**File**: `hierarchical-reasoning-protocol.md`  
**Category**: Structured Decomposition  
**Complexity**: High  

**Purpose**: Tiered reasoning with dependency management

**Core Pattern**:
```
Tier 1 (Foundation) → Tier 2 (Analysis) → Tier 3 (Strategy)
    ↓ Parallel          ↓ Parallel          ↓ Parallel
```

**When to Use**:
- Problems with clear dependency structure
- Foundation reasoning required before higher-order reasoning
- Opportunities for parallel exploration within tiers
- Complex multi-stage analysis

**Key Commitments**:
- Dependencies define structure (respect natural order)
- Parallelize within tiers, sequence across tiers
- Context shapes capability (filter appropriately)
- Integration is continuous (at every tier boundary)

**Primary Use Cases**:
- Market analysis (research → analysis → strategy)
- Multi-domain assessment (parallel experts → synthesis)
- Complex business decisions (data → insights → recommendations)
- Product strategy development

**Difficulty**: Advanced (requires careful dependency mapping)

---

### 2. Sequential Reasoning Protocol
**File**: `sequential-reasoning-protocol.md`  
**Category**: Pipeline Processing  
**Complexity**: Medium  

**Purpose**: Stage-by-stage transformation with intelligent handoffs

**Core Pattern**:
```
Stage 1 → Stage 2 → Stage 3 → Stage 4
Transform  Transform  Transform  Transform
```

**When to Use**:
- Clear sequential stages with dependencies
- Each stage performs discrete transformation
- Natural production pipeline exists
- Cumulative understanding through stages

**Key Commitments**:
- Sequence is structural (not arbitrary)
- Each stage has one clear transformation
- Handoffs are curated (not comprehensive)
- Context accumulates intelligently

**Primary Use Cases**:
- Software development (requirements → design → code → test)
- Content production (research → outline → draft → edit)
- Business processes (requirements → proposal → approval → execution)
- Manufacturing workflows

**Difficulty**: Intermediate (requires clear stage definition)

---

### 3. Strategic Reasoning Protocol
**File**: `strategic-reasoning-protocol.md`  
**Category**: Decision Acceleration  
**Complexity**: High  

**Purpose**: Accelerate decisions by exposing constraints and mapping authority

**Core Pattern**:
```
Diagnose Blocker → Extract Meta-Trait → Generate Questions → Map Authority → Framework
```

**When to Use**:
- Decision paralysis detected
- Authority ambiguity exists
- Strategic uncertainty present
- "Should we...?" questions
- Risk aversion blocking progress

**Key Commitments**:
- Problems are artifacts (not requests)
- Patterns over domains (abstract before solving)
- Questions are products (stress-test questions expose constraints)
- Authority precedes analysis
- Leverage over completeness

**Primary Use Cases**:
- Market entry decisions
- Strategic pivots
- Stakeholder alignment challenges
- Investment decisions under uncertainty
- Resource allocation conflicts

**Difficulty**: Advanced (requires pattern recognition and diagnosis)

---

### 4. Competitive Reasoning Protocol
**File**: `competitive-reasoning-protocol.md`  
**Category**: Parallel Evaluation  
**Complexity**: Medium-High  

**Purpose**: Generate diverse approaches and synthesize strengths

**Core Pattern**:
```
Approach A (Isolated) ─┐
Approach B (Isolated) ─┼─→ Criteria Evaluation → Synthesis
Approach C (Isolated) ─┘
```

**When to Use**:
- Creative problems (multiple valid solutions)
- Uncertain problems (best approach unclear)
- High-stakes decisions (need validation)
- Benefit from diverse perspectives

**Key Commitments**:
- Diversity is intentional (not accidental)
- Isolation preserves independence
- Evaluation must be criteria-based
- Synthesis extracts strengths (not just picks winner)
- Competition serves understanding

**Primary Use Cases**:
- Design problems (multiple design options)
- Creative strategy (positioning, branding)
- Novel problems (no established best practice)
- Optimization problems (finding best among many)

**Difficulty**: Intermediate-Advanced (requires isolation discipline and synthesis skill)

---

### 5. Iterative Reasoning Protocol
**File**: `iterative-reasoning-protocol.md`  
**Category**: Progressive Refinement  
**Complexity**: Medium  

**Purpose**: Systematic improvement toward quality thresholds

**Core Pattern**:
```
V1 → Quality Assessment → V2 → Assessment → V3 → Stop at Diminishing Returns
```

**When to Use**:
- Complex reasoning requiring refinement
- High-stakes thinking (quality critical)
- Clear quality improvement possible
- Time allows for refinement cycles

**Key Commitments**:
- Iteration is not repetition
- Quality must be measurable
- Feedback must be specific
- Diminishing returns are real
- Version control prevents regression

**Primary Use Cases**:
- Complex analysis requiring polish
- High-stakes reports or decisions
- Learning exercises (deliberate practice)
- Quality-critical outputs

**Difficulty**: Intermediate (requires quality measurement and discipline)

---

### 6. Federation Reasoning Protocol
**File**: `federation-reasoning-protocol.md`  
**Category**: Multi-Domain Integration  
**Complexity**: High  

**Purpose**: Coordinate across domains while preserving domain expertise

**Core Pattern**:
```
Technical Domain ──┐
Financial Domain ──┼─→ Cross-Domain Coordination → Integrated Synthesis
Market Domain ─────┤
Legal Domain ──────┘
```

**When to Use**:
- Problems span distinct domains
- Domain expertise must be preserved
- Cross-domain integration required
- Domains have different constraint systems

**Key Commitments**:
- Domains are natural (not arbitrary)
- Domain coordinators are essential
- Cross-domain integration is strategic
- Domain authority respects expertise
- Federation scales understanding

**Primary Use Cases**:
- Product launches (technical + market + financial + legal)
- Strategic decisions (multiple business perspectives)
- Due diligence (comprehensive multi-domain assessment)
- Complex projects (multiple specialized teams)

**Difficulty**: Advanced (requires domain coordination and integration)

---

### 7. Integration Reasoning Protocol
**File**: `integration-reasoning-protocol.md`  
**Category**: Stream Synthesis  
**Complexity**: Medium-High  

**Purpose**: Synthesize multiple reasoning streams into coherent understanding

**Core Pattern**:
```
Stream A ──┐
Stream B ──┼─→ Pattern Recognition → Conflict Resolution → Emergent Insights
Stream C ──┘
```

**When to Use**:
- Multiple reasoning streams need synthesis
- Perspectives need unification
- Conflicts require resolution
- Actionable integrated understanding needed

**Key Commitments**:
- Integration is not concatenation
- Patterns are integration's product
- Conflicts must be resolved
- Source attribution maintains integrity
- Synthesis creates actionability

**Primary Use Cases**:
- Multi-agent synthesis
- Cross-domain understanding
- Comprehensive reporting
- Decision support from multiple inputs

**Difficulty**: Intermediate-Advanced (requires pattern recognition and synthesis)

---

## Protocol Comparison Matrix

| Protocol | Complexity | Structure | Best For | Avoid For |
|----------|-----------|-----------|----------|-----------|
| **Hierarchical** | High | Tiered | Multi-stage with dependencies | Simple sequential |
| **Sequential** | Medium | Pipeline | Clear stage-by-stage | Parallel-suitable |
| **Strategic** | High | Diagnostic | Decision paralysis | Execution tasks |
| **Competitive** | Med-High | Parallel evaluation | Creative/uncertain | Mechanical problems |
| **Iterative** | Medium | Refinement cycles | Quality-critical | Time-sensitive |
| **Federation** | High | Multi-domain | Cross-domain problems | Single-domain |
| **Integration** | Med-High | Synthesis | Multiple streams | Single perspective |

## Protocol Complexity Ratings

**Beginner-Friendly**:
- Sequential Reasoning Protocol (clear stages)
- Iterative Reasoning Protocol (straightforward refinement)

**Intermediate**:
- Competitive Reasoning Protocol (requires evaluation discipline)
- Integration Reasoning Protocol (requires synthesis skill)

**Advanced**:
- Hierarchical Reasoning Protocol (complex dependency management)
- Strategic Reasoning Protocol (requires pattern recognition)
- Federation Reasoning Protocol (multi-domain coordination)

## Protocol Selection Decision Tree

```
START: What type of problem do you have?

┌─ Is there decision paralysis or authority ambiguity?
│  YES → Strategic Reasoning Protocol
│  NO  ↓

┌─ Does problem span technical, financial, legal, market domains?
│  YES → Federation Reasoning Protocol
│  NO  ↓

┌─ Are there clear sequential stages (A → B → C)?
│  YES → Sequential Reasoning Protocol
│  NO  ↓

┌─ Is there foundation → analysis → strategy structure?
│  YES → Hierarchical Reasoning Protocol
│  NO  ↓

┌─ Do you need multiple diverse approaches to explore?
│  YES → Competitive Reasoning Protocol
│  NO  ↓

┌─ Do you have multiple streams that need synthesis?
│  YES → Integration Reasoning Protocol
│  NO  ↓

└─ Does reasoning need quality refinement?
   YES → Iterative Reasoning Protocol
```

## Protocol Composition Patterns

### Common Combinations

**Pattern 1: Strategic → Federation → Integration**
- Strategic: Diagnose decision blocker
- Federation: Multi-domain analysis
- Integration: Synthesize into decision framework

**Use Case**: Major strategic decisions

---

**Pattern 2: Hierarchical → Iterative → Integration**
- Hierarchical: Build understanding in tiers
- Iterative: Refine each tier for quality
- Integration: Cross-tier synthesis

**Use Case**: Complex analysis requiring quality

---

**Pattern 3: Sequential → Competitive → Sequential**
- Sequential: Initial stages
- Competitive: Multiple design approaches
- Sequential: Continue with chosen approach

**Use Case**: Pipeline with design choices

---

**Pattern 4: Federation → Competitive → Integration**
- Federation: Gather domain perspectives
- Competitive: Multiple cross-domain strategies
- Integration: Select and synthesize best approach

**Use Case**: Complex strategy development

---

**Pattern 5: Hierarchical → Federation → Integration**
- Hierarchical: Stage research and analysis
- Federation: Domain-specific deeper dives
- Integration: Comprehensive synthesis

**Use Case**: Large-scale comprehensive assessment

## Protocol File Structure

Each protocol file follows this standard structure:

1. **Title & Subtitle** (Core concepts)
2. **Role** (Purpose and responsibility)
3. **Non-Negotiable Commitments** (Core principles)
4. **Protocol Flow** (Step-by-step process)
5. **Grammar** (Key conceptual distinctions)
6. **Error Forensics** (Failure diagnosis and recovery)
7. **Cognitive Stance** (Mindset and attitude)
8. **Internal Checks** (Self-validation)
9. **Ethos** (Why it works)
10. **Use Cases** (Specific applications)
11. **Anti-Patterns** (Common mistakes)

## Quick Reference Cards

### Hierarchical Protocol Card
```
Purpose: Tiered reasoning with dependencies
Pattern: Foundation → Analysis → Strategy (parallel within, sequential across)
Key Rule: Build foundation before higher-order reasoning
When: Complex multi-stage problems with clear dependencies
Example: Market research → Analysis → Strategy
```

### Sequential Protocol Card
```
Purpose: Pipeline transformation
Pattern: Stage 1 → Stage 2 → Stage 3 (each transforms input)
Key Rule: Each stage has one clear transformation
When: Clear sequential stages with handoffs
Example: Requirements → Design → Code → Test
```

### Strategic Protocol Card
```
Purpose: Decision acceleration
Pattern: Diagnose → Meta-trait → Questions → Authority → Framework
Key Rule: Questions over answers, diagnose before solving
When: Decision paralysis, authority unclear
Example: "Should we?" → Meta-trait → Stress-test questions
```

### Competitive Protocol Card
```
Purpose: Diverse evaluation
Pattern: Multiple isolated approaches → Criteria evaluation → Synthesis
Key Rule: Enforce isolation, synthesize strengths
When: Creative problems, multiple valid approaches
Example: 3 design approaches → Evaluate → Hybrid
```

### Iterative Protocol Card
```
Purpose: Progressive refinement
Pattern: V1 → Assessment → V2 → Assessment → V3
Key Rule: Measure improvement, stop at diminishing returns
When: Quality-critical reasoning, refinement beneficial
Example: Draft (70%) → Refined (85%) → Polished (93%)
```

### Federation Protocol Card
```
Purpose: Multi-domain coordination
Pattern: Technical + Financial + Market + Legal → Integration
Key Rule: Respect domain authority, synthesize across domains
When: Multiple distinct domains, expertise required
Example: Product launch across all business domains
```

### Integration Protocol Card
```
Purpose: Stream synthesis
Pattern: Multiple streams → Pattern recognition → Emergent insights
Key Rule: Integration ≠ concatenation, find patterns
When: Multiple streams need coherent synthesis
Example: Market + Tech + Finance → Integrated strategy
```

## Learning Path

### Beginner Path
1. Start with **Sequential Reasoning Protocol** (most intuitive)
2. Practice with **Iterative Reasoning Protocol** (builds on sequential)
3. Move to **Integration Reasoning Protocol** (synthesis skill)

### Intermediate Path
4. Learn **Competitive Reasoning Protocol** (parallel thinking)
5. Study **Hierarchical Reasoning Protocol** (dependencies)
6. Practice protocol combinations

### Advanced Path
7. Master **Strategic Reasoning Protocol** (diagnostic thinking)
8. Master **Federation Reasoning Protocol** (multi-domain coordination)
9. Create custom protocol compositions

## Related Documentation

**Quick Start**:
- `/docs/REASONING_PROTOCOLS_QUICK_REFERENCE.md` - Fast lookup guide

**Comprehensive**:
- `/docs/REASONING_PROTOCOLS_TRANSFORMATION.md` - Full transformation story
- `/reasoning-protocols/README.md` - Complete protocol system overview

**Individual Protocols**:
- `/reasoning-protocols/hierarchical-reasoning-protocol.md`
- `/reasoning-protocols/sequential-reasoning-protocol.md`
- `/reasoning-protocols/strategic-reasoning-protocol.md`
- `/reasoning-protocols/competitive-reasoning-protocol.md`
- `/reasoning-protocols/iterative-reasoning-protocol.md`
- `/reasoning-protocols/federation-reasoning-protocol.md`
- `/reasoning-protocols/integration-reasoning-protocol.md`

**Original Patterns** (for reference):
- `/agents/patterns/` - Original agentic pattern implementations

## Version History

**v1.0** (January 2026)
- Initial transformation from agentic patterns to reasoning protocols
- Seven core protocols established
- Complete documentation suite created

---

**This index is maintained as the authoritative reference for all reasoning protocols in the Worksona system.**