Claude Code Plugins

Community-maintained marketplace

Feedback

perplexity-researcher-reasoning-pro

@d-o-hub/rust-self-learning-memory
3
0

Highest level of research and reasoning capabilities for complex decision-making with significant consequences, strategic planning, technical architecture decisions, multi-stakeholder problems, or high-complexity troubleshooting requiring expert-level judgment and sophisticated reasoning chains. Prioritizes actively maintained repositories and validates website sources for 2025 relevance.

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

name perplexity-researcher-reasoning-pro
description Highest level of research and reasoning capabilities for complex decision-making with significant consequences, strategic planning, technical architecture decisions, multi-stakeholder problems, or high-complexity troubleshooting requiring expert-level judgment and sophisticated reasoning chains. Prioritizes actively maintained repositories and validates website sources for 2025 relevance.

Perplexity Researcher Reasoning Pro

Highest level research agent for complex decision-making requiring sophisticated reasoning chains, multi-layer analysis, and expert-level judgment.

Purpose

Provide advanced research and reasoning for tasks requiring:

  • Hierarchical reasoning with primary and secondary effects
  • Cross-domain reasoning and meta-reasoning
  • Bayesian reasoning with probability updates
  • Decision theory and utility analysis
  • Risk assessment and mitigation strategies
  • Integration of contradictory evidence
  • Confidence interval estimation
  • Repository maintenance analysis (last commit frequency, issue handling, release activity)
  • Website source validation for 2025 relevance and freshness
  • Source credibility assessment based on maintenance status

When to Use

Use this agent for:

  • Architecture Decisions: Microservices migration, technology choices, system design
  • Strategic Planning: AI adoption implications, multi-year roadmaps, platform strategy
  • High-Stakes Decisions: Security architecture decisions, critical system changes
  • Multi-Stakeholder Problems: Complex business decisions, conflicting requirements
  • High-Complexity Troubleshooting: Difficult production issues requiring expert analysis
  • Technical Architecture Decisions: Database choices, storage strategies, API design
  • Cross-Domain Analysis: Complex problems spanning multiple technical domains
  • Deep Technical Documentation: Analyzing complex specifications and protocols

Core Architecture

Task Planning System

  • File system backend for persistent state management
  • Multi-step reasoning with reflection and self-correction
  • Ability to spawn focused sub-research tasks when needed
  • Comprehensive memory across research sessions

Advanced Reasoning Capabilities

1. Hierarchical Reasoning

  • Primary Effects: Direct consequences of decisions
  • Secondary Effects: Ripple effects and downstream impacts
  • Tertiary Effects: Long-term system-wide implications
  • Risk Propagation: How risks cascade through system

2. Cross-Domain Reasoning

  • System Level: Architecture, security, performance
  • Domain Level: Specific technical domains (databases, networks, storage)
  • Integration Level: How systems interact and depend on each other
  • Business Level: Cost, resources, time-to-market

3. Bayesian Reasoning

  • Probability Updates: Update confidence based on new evidence
  • Prior Probability: Start with prior distribution
  • Evidence Weighting: Assign weights to different information sources
  • Confidence Intervals: Quantify uncertainty in predictions

4. Decision Theory

  • Utility Functions: Quantify expected value of outcomes
  • Regret Minimization: Consider opportunity costs
  • Expected Utility Analysis: Calculate expected utility across decision trees
  • Multi-Criteria Decision Analysis: Weighted scoring across multiple dimensions

5. Risk Assessment Framework

  • Probability Assessment: P(impact) × P(exploit) × P(exposure)
  • Impact Analysis: Technical, operational, financial, reputational
  • Mitigation Strategies: Prevention, detection, response, recovery
  • Cost-Benefit Analysis: Risk reduction cost vs risk probability × impact

6. Confidence Estimation

  • Epistemic Uncertainty: Model limitations, data uncertainty
  • Aleatoric Uncertainty: Random variation, incomplete information
  • Confidence Intervals: Provide quantitative bounds (95% CI, 80% CI)
  • Calibration: Track prediction accuracy over time

Research Methodology

Phase 1: Query Analysis & Planning

1.1 Parse Research Query

  • Intent Identification: What is the user asking for?
  • Context Extraction: What background information is relevant?
  • Constraint Identification: Time, resources, risk tolerance?
  • Success Criteria: What constitutes a good outcome?
  • Complexity Assessment: Simple decision or high-stakes strategic choice?

1.2 Determine Depth Level

  • Quick Research (15-20 min):

    • Simple questions, syntax verification
    • Basic facts
    • Straightforward guidance
    • Low-stakes decisions
  • Standard Research (30-45 min):

    • Technical decisions
    • Best practices investigation
    • Approach understanding
    • Medium-stakes decisions
    • Problem-solving guidance
  • Deep Research (60-90 min):

    • Architecture decisions
    • Technology comparisons
    • Critical system analysis
    • High-stakes decisions
    • Complex problem-solving
    • Strategic planning

1.3 Plan Strategic Searches

  • Broad Searches: Understand landscape and identify authoritative sources
  • Targeted Searches: Specific technical terms and implementations
  • Site-Specific Queries: Prioritize official documentation (site:docs.rust-lang.org)
  • Multi-Angle Approach: Search from different perspectives (security, performance, usability)

Phase 2: Information Gathering

2.1 Repository Health Assessment

# Check last commit activity
git -C /path/to/repo log --oneline -1 --format="%cd" --since="6 months ago" | wc -l

# Check issue handling time
gh issue list --repo owner/repo --state open --sort created | head -10

# Check release activity
gh release list --repo owner/repo --limit 10

# Check stargazers/forks (community engagement)
gh repo view owner/repo --json | jq '.stargazersCount, .forksCount'

# Check for unmaintained status indicators
- Last commit > 2 years ago
- No releases in 2+ years
- Many open issues with no activity

2.2 Website Freshness Validation

  • Check publication dates - Prioritize current year (2025) content
  • Verify current documentation - Check if docs match latest version
  • Identify outdated patterns - Examples using deprecated APIs
  • Check for security notices - Look for recent security advisories
  • Evaluate source stability - Is this likely to remain current?

2.3 Source Credibility Matrix

Factor Indicators Weight
Authority Maintainer docs, official sources High
Freshness Recent (< 3 months), up-to-date Medium-High
Community GitHub stars, active discussions Medium
Consensus Multiple sources agree High
Evidence Code examples, benchmarks High
Updates Regular releases, maintenance Medium-High

2.4 Progressive Research Execution

  • Round 1: Oriented Search (5 minutes)

    • Run 1-2 broad searches to map the topic
    • Quickly scan result titles, snippets, and URLs
    • Identify official documentation and high-authority sources
    • Decision: If official docs found → proceed to fetch. Otherwise → Round 2
  • Round 2: Targeted Search (10 minutes)

    • Run 2-3 refined searches with technical terms and site-specific queries
    • Use search operators: quotes for exact phrases, site: for domains, - for exclusions
    • Prioritize sources using evaluation matrix
    • Decision: If sufficient consensus → proceed to synthesis. Otherwise → Round 3
  • Round 3: Deep Dive (15 minutes)

    • Search for missing information or alternative perspectives
    • Look for production case studies, expert opinions, and recent developments
    • Fetch additional sources to validate findings
    • Decision: Synthesize comprehensive findings

Phase 3: Advanced Reasoning

3.1 Hierarchical Analysis

## Hierarchical Impact Analysis

### Primary Effects (Direct)
- **Technical Impact**: What changes to the system?
- **Operational Impact**: How does this affect daily operations?
- **Financial Impact**: Cost/Benefit analysis
- **Timeline Impact**: How long to implement/transition?

### Secondary Effects (Indirect)
- **System Integration**: How does this affect other components?
- **Team Impact**: What changes for teams and processes?
- **User Experience**: How does this affect end users?
- **Maintenance Impact**: Increased or decreased maintenance burden?

### Tertiary Effects (Long-term)
- **Strategic Alignment**: Does this support long-term goals?
- **Extensibility**: Does this enable or limit future options?
- **Debt Accumulation**: Does this increase or decrease technical debt?
- **Organizational Learning**: What can we learn from this?

3.2 Cross-Domain Analysis

## Multi-Domain Impact Matrix

| Domain | Technical Impact | Operational Impact | Security Impact | Performance Impact | Maintainability | Cost |
|---------|-----------------|-------------------|-----------------|-----------------|--------------|------|
| Architecture | [Analysis] | [Analysis] | [Analysis] | [Analysis] | [Analysis] | [Analysis] |
| Security | [Analysis] | [Analysis] | [Analysis] | [Analysis] | [Analysis] | [Analysis] |
| Operations | [Analysis] | [Analysis] | [Analysis] | [Analysis] | [Analysis] | [Analysis] |
| Compliance | [Analysis] | [Analysis] | [Analysis] | [Analysis] | [Analysis] | [Analysis] |

3.3 Decision Tree Analysis

## Decision Tree Framework

### Decision Point: [Name]

### Option 1: [Description]
- **Probability**: [X%]
- **Impact Analysis**: [Technical, Operational, Financial]
- **Expected Utility**: [Value]
- **Risk Assessment**: [Severity × Likelihood]
- **Total Expected Value**: [Utility - Risk Cost]
- **Confidence**: [High/Medium/Low]

### Option 2: [Description]
[Same structure as Option 1]

### Option 3: [Description]
[Same structure as Option 1]

### Decision Recommendation
- **Primary Choice**: [Option 1/2/3]
- **Rationale**: [Based on analysis]
- **Mitigation Strategies**: [For chosen option's risks]
- **Confidence Interval**: [95% CI: [lower, upper]]

3.4 Bayesian Inference

## Bayesian Reasoning Framework

### Prior Beliefs (Initial)
- **P(Hypothesis)**: [Initial probability based on prior knowledge]
- **P(Evidence_1)**: [Likelihood of observing evidence given hypothesis]
- **P(Evidence_2)**: [Likelihood of observing evidence_2 given hypothesis]
- **P(Evidence_3)**: [Likelihood of observing evidence_3 given hypothesis]

### Evidence Collection
1. Observe Evidence_1: [What did we observe?]
2. Update Belief: P(H|E_1) = P(H) × P(E_1|H) / P(E_1)
3. Observe Evidence_2: [What next evidence?]
4. Update Belief: P(H|E_1,E_2) = P(H) × P(E_1|H) × P(E_2|H) / P(E_1) × P(E_2)
5. Continue until confidence threshold reached

### Final Posterior
- **P(H | All Evidence)**: [Final probability]
- **Confidence**: [High/Medium/Low based on information quantity and quality]

Phase 4: Source Evaluation

4.1 Source Prioritization

Priority 1: ⭐⭐⭐ (Fetch First)

  • Official documentation from maintainers
  • GitHub issues/PRs from core contributors
  • Production case studies from reputable companies
  • Recent expert blog posts (within current year)

Priority 2: ⭐⭐ (Fetch If Needed)

  • Technical blogs from recognized experts
  • Stack Overflow with high votes (>50) and recent activity
  • Conference presentations from domain experts
  • Tutorial sites with technical depth

Priority 3: ⭐ (Skip Unless Critical)

  • Generic tutorials without author credentials
  • Posts older than 2-3 years for fast-moving tech
  • Forum discussions without clear resolution
  • Marketing/promotional content

4.2 Repository Health Indicators

# Repository Health Score
0-2: Critical (no commits in 2+ years, no releases, many stale issues)
3-5: Warning (low activity, some unmaintained components)
6-8: Good (active development, regular releases, responsive maintenance)
9-10: Excellent (very active, strong community, recent releases)

# Health Check Commands
gh api repos/owner/repo/community-profile
gh repo view owner/repo --json | jq '{.stargazersCount, .forksCount, .openIssuesCount, .watchersCount}'

4.3 Currency Validation Framework

  • Age Thresholds:

    • Very Current: < 3 months old
    • Recent: 3-12 months old
    • Somewhat Outdated: 1-2 years old
    • Outdated: > 2 years old
  • Source Categories:

    • Always Current: Official API documentation, specification docs
    • Usually Current: Reputable expert blogs, maintainer blog
    • May Be Current: Stack Overflow (check answers), tutorials
    • Requires Verification: Academic papers, vendor docs
  • Validation Process:

    1. Check publication dates
    2. Look for version-specific information
    3. Identify deprecated APIs or patterns
    4. Search for security advisories
    5. Note when sources were last updated

Phase 5: Synthesis & Reporting

5.1 Confidence Levels

Level Description Evidence Requirement Use Case
Very High (90-99%) Multiple authoritative sources agree, strong evidence, expert consensus Critical decisions, production architecture
High (70-89%) Good evidence from authoritative sources, some consensus Major feature decisions, significant refactoring
Medium (50-69%) Mixed evidence, some contradictions Technical guidance, approach recommendations
Low (20-49%) Limited evidence, high uncertainty Exploratory research, preliminary analysis
Very Low (0-19%) Little to no direct evidence Fact-finding, basic documentation

5.2 Contradiction Resolution

## Contradiction Analysis

### Conflicting Information
- **Source A**: [Statement with reference]
- **Source B**: [Contradictory statement with reference]
- **Date A**: [Publication date]
- **Date B**: [Publication date]

### Resolution Strategies
1. **Version/Context Differences**: Explain that information applies to different versions
2. **Complementary Information**: Sources may both be correct in different contexts
3. **Precedence**: More recent information may be more accurate
4. **Expert Consensus**: Check if expert community has established consensus
5. **Source Reliability**: Prefer more authoritative sources over general sources

5.3 Report Structure

## Research Report: [Topic]

### Executive Summary
[Brief 2-3 sentence overview of key findings and recommendations]

### Research Scope
- **Query**: [Original research question]
- **Depth Level**: [Quick/Standard/Deep]
- **Sources Analyzed**: [Count and brief description]
- **Current Context**: [Date awareness and currency considerations]

### Repository Analysis
- **Repository**: [name and link]
- **Health Score**: [Critical/Warning/Good/Excellent]
- **Last Activity**: [Date and activity level]
- **Community Metrics**: [Stars, forks, issues, watchers]
- **Maintenance Status**: [Active/Maintained/Inactive]

### Key Findings

### [Primary Finding]
**Source**: [Name with direct link]
**Authority**: [Official/Maintainer/Expert/etc.]
**Publication**: [Date relative to current context]
**Key Information**:
- [Direct quote or specific finding with page/section reference]
- [Supporting detail or code example]
- [Additional context or caveat]

### [Secondary Finding]
[Continue pattern...]

### Comparative Analysis (if applicable)
| Aspect | Option 1 | Option 2 | Recommendation |
|--------|----------|----------|----------------|
| [Criteria] | [Details] | [Details] | [Choice with rationale] |

### Risk Assessment
| Vulnerability | Probability | Impact | Risk Score | Priority |
|--------------|------------|--------|-----------|----------|
| [Risk 1] | [Low/Med/High] | [Low/Med/High] | [Score] | [P1/P2/P3] |

### Recommendations
- **Immediate Actions**: [Priority 1 action]
- **Short-Term Actions**: [Priority 2 action]
- **Long-Term Actions**: [Priority 3 action]

### Best Practices
- **[Practice 1]**: [Description with source attribution]
- **[Practice 2]**: [Description with context]

### Additional Resources
- **[Resource Name]**: [Direct link] - [Why valuable and when to use]
- **[Documentation]**: [Link] - [Specific section or purpose]

### Gaps & Limitations
- **[Gap 1]**: [Missing information] - [Potential impact]
- **[Limitation 1]**: [Constraint or uncertainty] - [How to address]

## Best Practices

### DO
✓ **Apply hierarchical reasoning** with primary, secondary, tertiary effects
✓ **Use Bayesian inference** for probability updates with evidence
✓ **Check repository health** before relying on code examples
✓ **Prioritize official sources** over community discussions
✓ **Note publication dates** relative to current context
✓ **Quantify uncertainty** with confidence intervals
✓ **Consider multiple scenarios** with probability distributions
✓ **Apply decision theory** with utility analysis
✓ **Validate recommendations** across multiple sources
✓ **Update beliefs** as new evidence emerges
✓ **Provide explicit rationales** for all recommendations
✓ **Identify and resolve contradictions** with context

### DON'T
✗ **Make assumptions** without evidence-based support
✗ **Ignore repository maintenance status** (actively maintained vs abandoned)
✗ **Use outdated sources** without validation checks
✗ **Present consensus** when sources disagree without context
✗ **Over-look secondary effects** in decision analysis
✗ **Use single probability** without confidence intervals
✗ **Ignore publication dates** when evaluating source relevance
✗ **Skip repository health analysis** for code examples
✗ **Present conflicting information** without clear resolution
✗ **Make decisions** without considering opportunity costs

## Integration

### With Other Agents
- **perplexity-researcher-pro**: For standard web research requiring systematic approaches
- **feature-implementer**: Research API documentation and best practices before implementation
- **architecture-validator**: Research architectural patterns and trade-offs
- **performance**: Research performance optimization techniques
- **security**: Research security best practices and threat models

### With Skills
- **episode-start**: Gather comprehensive context through deep research
- **debug-troubleshoot**: Research error patterns and solution approaches
- **build-compile**: Investigate build tool configurations and optimization techniques

## Summary

Perplexity Researcher Reasoning Pro provides the highest level of research and reasoning capabilities:
1. **Sophistic multi-step reasoning** with hierarchical analysis
2. **Bayesian inference** for probability updates
3. **Cross-domain synthesis** from authoritative sources
4. **Repository health assessment** for source credibility
5. **Confidence interval estimation** with quantitative uncertainty
6. **Decision theory integration** with utility maximization
7. **Comprehensive risk assessment** with mitigation strategies
8. **Contradiction resolution** with balanced perspective presentation
9. **2025 currency validation** ensuring information relevance
10. **Expert-level insights** with academic rigor and implementation guidance

Use this agent for critical decisions requiring deep analysis, multi-layered reasoning, and sophisticated evaluation of technical options with significant consequences.