mirror of
https://github.com/SuperClaude-Org/SuperClaude_Framework.git
synced 2025-12-29 16:16:08 +00:00
refactor(docs): move core docs into framework/business/research (move-only)
- framework/: principles, rules, flags (思想・行動規範) - business/: symbols, examples (ビジネス領域) - research/: config (調査設定) - All files renamed to lowercase for consistency
This commit is contained in:
446
superclaude/research/config.md
Normal file
446
superclaude/research/config.md
Normal file
@@ -0,0 +1,446 @@
|
||||
# Deep Research Configuration
|
||||
|
||||
## Default Settings
|
||||
|
||||
```yaml
|
||||
research_defaults:
|
||||
planning_strategy: unified
|
||||
max_hops: 5
|
||||
confidence_threshold: 0.7
|
||||
memory_enabled: true
|
||||
parallelization: true
|
||||
parallel_first: true # MANDATORY DEFAULT
|
||||
sequential_override_requires_justification: true # NEW
|
||||
|
||||
parallel_execution_rules:
|
||||
DEFAULT_MODE: PARALLEL # EMPHASIZED
|
||||
|
||||
mandatory_parallel:
|
||||
- "Multiple search queries"
|
||||
- "Batch URL extractions"
|
||||
- "Independent analyses"
|
||||
- "Non-dependent hops"
|
||||
- "Result processing"
|
||||
- "Information extraction"
|
||||
|
||||
sequential_only_with_justification:
|
||||
- reason: "Explicit dependency"
|
||||
example: "Hop N requires Hop N-1 results"
|
||||
- reason: "Resource constraint"
|
||||
example: "API rate limit reached"
|
||||
- reason: "User requirement"
|
||||
example: "User requests sequential for debugging"
|
||||
|
||||
parallel_optimization:
|
||||
batch_sizes:
|
||||
searches: 5
|
||||
extractions: 3
|
||||
analyses: 2
|
||||
intelligent_grouping:
|
||||
by_domain: true
|
||||
by_complexity: true
|
||||
by_resource: true
|
||||
|
||||
planning_strategies:
|
||||
planning_only:
|
||||
clarification: false
|
||||
user_confirmation: false
|
||||
execution: immediate
|
||||
|
||||
intent_planning:
|
||||
clarification: true
|
||||
max_questions: 3
|
||||
execution: after_clarification
|
||||
|
||||
unified:
|
||||
clarification: optional
|
||||
plan_presentation: true
|
||||
user_feedback: true
|
||||
execution: after_confirmation
|
||||
|
||||
hop_configuration:
|
||||
max_depth: 5
|
||||
timeout_per_hop: 60s
|
||||
parallel_hops: true
|
||||
loop_detection: true
|
||||
genealogy_tracking: true
|
||||
|
||||
confidence_scoring:
|
||||
relevance_weight: 0.5
|
||||
completeness_weight: 0.5
|
||||
minimum_threshold: 0.6
|
||||
target_threshold: 0.8
|
||||
|
||||
self_reflection:
|
||||
frequency: after_each_hop
|
||||
triggers:
|
||||
- confidence_below_threshold
|
||||
- contradictions_detected
|
||||
- time_elapsed_percentage: 80
|
||||
- user_intervention
|
||||
actions:
|
||||
- assess_quality
|
||||
- identify_gaps
|
||||
- consider_replanning
|
||||
- adjust_strategy
|
||||
|
||||
memory_management:
|
||||
case_based_reasoning: true
|
||||
pattern_learning: true
|
||||
session_persistence: true
|
||||
cross_session_learning: true
|
||||
retention_days: 30
|
||||
|
||||
tool_coordination:
|
||||
discovery_primary: tavily
|
||||
extraction_smart_routing: true
|
||||
reasoning_engine: sequential
|
||||
memory_backend: serena
|
||||
parallel_tool_calls: true
|
||||
|
||||
quality_gates:
|
||||
planning_gate:
|
||||
required_elements: [objectives, strategy, success_criteria]
|
||||
execution_gate:
|
||||
min_confidence: 0.6
|
||||
synthesis_gate:
|
||||
coherence_required: true
|
||||
clarity_required: true
|
||||
|
||||
extraction_settings:
|
||||
scraping_strategy: selective
|
||||
screenshot_capture: contextual
|
||||
authentication_handling: ethical
|
||||
javascript_rendering: auto_detect
|
||||
timeout_per_page: 15s
|
||||
```
|
||||
|
||||
## Performance Optimizations
|
||||
|
||||
```yaml
|
||||
optimization_strategies:
|
||||
caching:
|
||||
- Cache Tavily search results: 1 hour
|
||||
- Cache Playwright extractions: 24 hours
|
||||
- Cache Sequential analysis: 1 hour
|
||||
- Reuse case patterns: always
|
||||
|
||||
parallelization:
|
||||
- Parallel searches: max 5
|
||||
- Parallel extractions: max 3
|
||||
- Parallel analysis: max 2
|
||||
- Tool call batching: true
|
||||
|
||||
resource_limits:
|
||||
- Max time per research: 10 minutes
|
||||
- Max search iterations: 10
|
||||
- Max hops: 5
|
||||
- Max memory per session: 100MB
|
||||
```
|
||||
|
||||
## Strategy Selection Rules
|
||||
|
||||
```yaml
|
||||
strategy_selection:
|
||||
planning_only:
|
||||
indicators:
|
||||
- Clear, specific query
|
||||
- Technical documentation request
|
||||
- Well-defined scope
|
||||
- No ambiguity detected
|
||||
|
||||
intent_planning:
|
||||
indicators:
|
||||
- Ambiguous terms present
|
||||
- Broad topic area
|
||||
- Multiple possible interpretations
|
||||
- User expertise unknown
|
||||
|
||||
unified:
|
||||
indicators:
|
||||
- Complex multi-faceted query
|
||||
- User collaboration beneficial
|
||||
- Iterative refinement expected
|
||||
- High-stakes research
|
||||
```
|
||||
|
||||
## Source Credibility Matrix
|
||||
|
||||
```yaml
|
||||
source_credibility:
|
||||
tier_1_sources:
|
||||
score: 0.9-1.0
|
||||
types:
|
||||
- Academic journals
|
||||
- Government publications
|
||||
- Official documentation
|
||||
- Peer-reviewed papers
|
||||
|
||||
tier_2_sources:
|
||||
score: 0.7-0.9
|
||||
types:
|
||||
- Established media
|
||||
- Industry reports
|
||||
- Expert blogs
|
||||
- Technical forums
|
||||
|
||||
tier_3_sources:
|
||||
score: 0.5-0.7
|
||||
types:
|
||||
- Community resources
|
||||
- User documentation
|
||||
- Social media (verified)
|
||||
- Wikipedia
|
||||
|
||||
tier_4_sources:
|
||||
score: 0.3-0.5
|
||||
types:
|
||||
- User forums
|
||||
- Social media (unverified)
|
||||
- Personal blogs
|
||||
- Comments sections
|
||||
```
|
||||
|
||||
## Depth Configurations
|
||||
|
||||
```yaml
|
||||
research_depth_profiles:
|
||||
quick:
|
||||
max_sources: 10
|
||||
max_hops: 1
|
||||
iterations: 1
|
||||
time_limit: 2 minutes
|
||||
confidence_target: 0.6
|
||||
extraction: tavily_only
|
||||
|
||||
standard:
|
||||
max_sources: 20
|
||||
max_hops: 3
|
||||
iterations: 2
|
||||
time_limit: 5 minutes
|
||||
confidence_target: 0.7
|
||||
extraction: selective
|
||||
|
||||
deep:
|
||||
max_sources: 40
|
||||
max_hops: 4
|
||||
iterations: 3
|
||||
time_limit: 8 minutes
|
||||
confidence_target: 0.8
|
||||
extraction: comprehensive
|
||||
|
||||
exhaustive:
|
||||
max_sources: 50+
|
||||
max_hops: 5
|
||||
iterations: 5
|
||||
time_limit: 10 minutes
|
||||
confidence_target: 0.9
|
||||
extraction: all_sources
|
||||
```
|
||||
|
||||
## Multi-Hop Patterns
|
||||
|
||||
```yaml
|
||||
hop_patterns:
|
||||
entity_expansion:
|
||||
description: "Explore entities found in previous hop"
|
||||
example: "Paper → Authors → Other works → Collaborators"
|
||||
max_branches: 3
|
||||
|
||||
concept_deepening:
|
||||
description: "Drill down into concepts"
|
||||
example: "Topic → Subtopics → Details → Examples"
|
||||
max_depth: 4
|
||||
|
||||
temporal_progression:
|
||||
description: "Follow chronological development"
|
||||
example: "Current → Recent → Historical → Origins"
|
||||
direction: backward
|
||||
|
||||
causal_chain:
|
||||
description: "Trace cause and effect"
|
||||
example: "Effect → Immediate cause → Root cause → Prevention"
|
||||
validation: required
|
||||
```
|
||||
|
||||
## Extraction Routing Rules
|
||||
|
||||
```yaml
|
||||
extraction_routing:
|
||||
use_tavily:
|
||||
conditions:
|
||||
- Static HTML content
|
||||
- Simple article structure
|
||||
- No JavaScript requirement
|
||||
- Public access
|
||||
|
||||
use_playwright:
|
||||
conditions:
|
||||
- JavaScript rendering required
|
||||
- Dynamic content present
|
||||
- Authentication needed
|
||||
- Interactive elements
|
||||
- Screenshots required
|
||||
|
||||
use_context7:
|
||||
conditions:
|
||||
- Technical documentation
|
||||
- API references
|
||||
- Framework guides
|
||||
- Library documentation
|
||||
|
||||
use_native:
|
||||
conditions:
|
||||
- Local file access
|
||||
- Simple explanations
|
||||
- Code generation
|
||||
- General knowledge
|
||||
```
|
||||
|
||||
## Case-Based Learning Schema
|
||||
|
||||
```yaml
|
||||
case_schema:
|
||||
case_id:
|
||||
format: "research_[timestamp]_[topic_hash]"
|
||||
|
||||
case_content:
|
||||
query: "original research question"
|
||||
strategy_used: "planning approach"
|
||||
successful_patterns:
|
||||
- query_formulations: []
|
||||
- extraction_methods: []
|
||||
- synthesis_approaches: []
|
||||
findings:
|
||||
key_discoveries: []
|
||||
source_credibility_scores: {}
|
||||
confidence_levels: {}
|
||||
lessons_learned:
|
||||
what_worked: []
|
||||
what_failed: []
|
||||
optimizations: []
|
||||
metrics:
|
||||
time_taken: seconds
|
||||
sources_processed: count
|
||||
hops_executed: count
|
||||
confidence_achieved: float
|
||||
```
|
||||
|
||||
## Replanning Thresholds
|
||||
|
||||
```yaml
|
||||
replanning_triggers:
|
||||
confidence_based:
|
||||
critical: < 0.4
|
||||
low: < 0.6
|
||||
acceptable: 0.6-0.7
|
||||
good: > 0.7
|
||||
|
||||
time_based:
|
||||
warning: 70% of limit
|
||||
critical: 90% of limit
|
||||
|
||||
quality_based:
|
||||
insufficient_sources: < 3
|
||||
contradictions: > 30%
|
||||
gaps_identified: > 50%
|
||||
|
||||
user_based:
|
||||
explicit_request: immediate
|
||||
implicit_dissatisfaction: assess
|
||||
```
|
||||
|
||||
## Output Format Templates
|
||||
|
||||
```yaml
|
||||
output_formats:
|
||||
summary:
|
||||
max_length: 500 words
|
||||
sections: [key_finding, evidence, sources]
|
||||
confidence_display: simple
|
||||
|
||||
report:
|
||||
sections: [executive_summary, methodology, findings, synthesis, conclusions]
|
||||
citations: inline
|
||||
confidence_display: detailed
|
||||
visuals: included
|
||||
|
||||
academic:
|
||||
sections: [abstract, introduction, methodology, literature_review, findings, discussion, conclusions]
|
||||
citations: academic_format
|
||||
confidence_display: statistical
|
||||
appendices: true
|
||||
```
|
||||
|
||||
## Error Handling
|
||||
|
||||
```yaml
|
||||
error_handling:
|
||||
tavily_errors:
|
||||
api_key_missing: "Check TAVILY_API_KEY environment variable"
|
||||
rate_limit: "Wait and retry with exponential backoff"
|
||||
no_results: "Expand search terms or try alternatives"
|
||||
|
||||
playwright_errors:
|
||||
timeout: "Skip source or increase timeout"
|
||||
navigation_failed: "Mark as inaccessible, continue"
|
||||
screenshot_failed: "Continue without visual"
|
||||
|
||||
quality_errors:
|
||||
low_confidence: "Trigger replanning"
|
||||
contradictions: "Seek additional sources"
|
||||
insufficient_data: "Expand search scope"
|
||||
```
|
||||
|
||||
## Integration Points
|
||||
|
||||
```yaml
|
||||
mcp_integration:
|
||||
tavily:
|
||||
role: primary_search
|
||||
fallback: native_websearch
|
||||
|
||||
playwright:
|
||||
role: complex_extraction
|
||||
fallback: tavily_extraction
|
||||
|
||||
sequential:
|
||||
role: reasoning_engine
|
||||
fallback: native_reasoning
|
||||
|
||||
context7:
|
||||
role: technical_docs
|
||||
fallback: tavily_search
|
||||
|
||||
serena:
|
||||
role: memory_management
|
||||
fallback: session_only
|
||||
```
|
||||
|
||||
## Monitoring Metrics
|
||||
|
||||
```yaml
|
||||
metrics_tracking:
|
||||
performance:
|
||||
- search_latency
|
||||
- extraction_time
|
||||
- synthesis_duration
|
||||
- total_research_time
|
||||
|
||||
quality:
|
||||
- confidence_scores
|
||||
- source_diversity
|
||||
- coverage_completeness
|
||||
- contradiction_rate
|
||||
|
||||
efficiency:
|
||||
- cache_hit_rate
|
||||
- parallel_execution_rate
|
||||
- memory_usage
|
||||
- api_cost
|
||||
|
||||
learning:
|
||||
- pattern_reuse_rate
|
||||
- strategy_success_rate
|
||||
- improvement_trajectory
|
||||
```
|
||||
Reference in New Issue
Block a user