disciplined-research

# Research Document: [Feature/Change Name]

**Status**: Draft | Review | Approved
**Author**: [Name]
**Date**: [YYYY-MM-DD]
**Reviewers**: [Names]

## Executive Summary

[2-3 sentence summary of the problem and key findings]

## Essential Questions Check

| Question | Answer | Evidence |
|----------|--------|----------|
| Energizing? | Yes/No | [Why this matters to us] |
| Leverages strengths? | Yes/No | [Our unique capability] |
| Meets real need? | Yes/No | [Validated need source] |

**Proceed**: [Yes - at least 2/3 YES / No - challenge essentiality]

## Problem Statement

### Description
[Clear description of what problem we're solving]

### Impact
[Who is affected and how]

### Success Criteria
[How we know we've solved the problem]

## Current State Analysis

### Existing Implementation
[Description of current code/systems]

### Code Locations
| Component | Location | Purpose |
|-----------|----------|---------|
| [Name] | `path/to/code.rs` | [Purpose] |

### Data Flow
[How data currently flows through the system]

### Integration Points
[APIs, services, protocols currently used]

## Constraints

### Technical Constraints
- [Constraint 1]: [Description and source]
- [Constraint 2]: [Description and source]

### Business Constraints
- [Constraint 1]: [Description and source]

### Non-Functional Requirements
| Requirement | Target | Current |
|-------------|--------|---------|
| Latency | < X ms | Y ms |
| Throughput | X req/s | Y req/s |

## Vital Few (Essentialism)

### Essential Constraints (Max 3)
List only the constraints that actually matter (not everything that could matter):

| Constraint | Why It's Vital | Evidence |
|------------|----------------|----------|
| [Must have X] | [Impact if missing] | [Source] |

### Eliminated from Scope
Apply the 5/25 Rule. List what you explicitly chose NOT to investigate:

| Eliminated Item | Why Eliminated |
|-----------------|----------------|
| [Topic/Feature] | [Not in top 5 priorities] |

## Dependencies

### Internal Dependencies
| Dependency | Impact | Risk |
|------------|--------|------|
| [Module] | [How it affects us] | [Risk level] |

### External Dependencies
| Dependency | Version | Risk | Alternative |
|------------|---------|------|-------------|
| [Crate] | X.Y.Z | [Risk] | [Alternative] |

## Risks and Unknowns

### Known Risks
| Risk | Likelihood | Impact | Mitigation |
|------|------------|--------|------------|
| [Risk 1] | High/Med/Low | High/Med/Low | [Strategy] |

### Open Questions
1. [Question 1] - [Who can answer]
2. [Question 2] - [Required investigation]

### Assumptions
1. [Assumption 1] - [Basis for assumption]
2. [Assumption 2] - [Basis for assumption]

## Research Findings

### Key Insights
1. [Insight 1]
2. [Insight 2]

### Relevant Prior Art
- [Project/Paper 1]: [Relevance]
- [Project/Paper 2]: [Relevance]

### Technical Spikes Needed
| Spike | Purpose | Estimated Effort |
|-------|---------|------------------|
| [Spike 1] | [What we need to learn] | [Hours/Days] |

## Recommendations

### Proceed/No-Proceed
[Recommendation with justification]

### Scope Recommendations
[Suggestions for scope based on findings]

### Risk Mitigation Recommendations
[How to address identified risks]

## Next Steps

If approved:
1. [Next step 1]
2. [Next step 2]

## Appendix

### Reference Materials
- [Link 1]
- [Link 2]

### Code Snippets
[Relevant code examples from analysis]

# Find all files related to feature
rg "feature_name" --type rust

# Understand recent changes
git log --oneline -20 -- path/to/module

# Find who knows this code
git shortlog -sn -- path/to/module

# Trace function usage
rg "function_name\(" --type rust

# Show dependency tree
cargo tree

# Find why a crate is included
cargo tree -i crate_name

# Check for security issues
cargo audit

// Document public interfaces found
pub trait DiscoveredInterface {
    fn method(&self) -> Result<Output, Error>;
}

// Note extension points
// Extension point: Implement Handler trait for custom behavior