id = "strategist"
version = "1.0.0"
name = "Strategist Hand"
description = "Autonomous strategy analyst — market research, competitive analysis, business planning, and strategic recommendations"

category = "productivity"
icon = "🎯"

tools = [
  "shell_exec",
  "file_read",
  "file_write",
  "file_list",
  "web_fetch",
  "web_search",
  "memory_store",
  "memory_recall",
  "schedule_create",
  "schedule_list",
  "schedule_delete",
  "knowledge_add_entity",
  "knowledge_add_relation",
  "knowledge_query",
  "event_publish",
]

[routing]
aliases = [
  "strategic analysis",
  "competitive analysis",
  "business plan",
  "market research",
  "business strategy",
  "swot analysis",
  "market strategy",
  "competitive strategy",
]
weak_aliases = [
  "swot",
  "industry report",
  "competitive landscape",
  "porter analysis",
  "go to market",
  "strategy memo",
]

# ─── Configurable settings ───────────────────────────────────────────────────

[[settings]]
key = "focus_area"
label = "Focus Area"
description = "Primary area of strategic analysis"
setting_type = "select"
default = "general"

[[settings.options]]
value = "general"
label = "General Business Strategy"

[[settings.options]]
value = "market_entry"
label = "Market Entry & Expansion"

[[settings.options]]
value = "competitive"
label = "Competitive Intelligence"

[[settings.options]]
value = "product"
label = "Product Strategy"

[[settings.options]]
value = "growth"
label = "Growth Strategy"

[[settings]]
key = "analysis_depth"
label = "Analysis Depth"
description = "How thorough each strategic analysis should be"
setting_type = "select"
default = "thorough"

[[settings.options]]
value = "quick"
label = "Quick (key insights, 1-2 pages)"

[[settings.options]]
value = "thorough"
label = "Thorough (detailed analysis, 5-10 pages)"

[[settings.options]]
value = "comprehensive"
label = "Comprehensive (full strategic report, 15+ pages)"

[[settings]]
key = "industry"
label = "Industry"
description = "Primary industry to focus analysis on (e.g. SaaS, fintech, healthcare)"
setting_type = "text"
default = ""

[[settings]]
key = "competitors"
label = "Key Competitors"
description = "Comma-separated list of competitors to track"
setting_type = "text"
default = ""

[[settings]]
key = "auto_monitor"
label = "Auto Monitor"
description = "Automatically track competitor moves and market changes"
setting_type = "toggle"
default = "false"

[[settings]]
key = "report_format"
label = "Report Format"
description = "How to format strategic reports"
setting_type = "select"
default = "executive"

[[settings.options]]
value = "executive"
label = "Executive Brief"

[[settings.options]]
value = "detailed"
label = "Detailed Analysis"

[[settings.options]]
value = "slide_deck"
label = "Slide Deck Outline"

[[settings.options]]
value = "memo"
label = "Strategy Memo"

[[settings]]
key = "confidence_threshold"
label = "Confidence Threshold"
description = "Minimum confidence level for including findings in reports"
setting_type = "select"
default = "medium"

[[settings.options]]
value = "low"
label = "Low (include speculative insights)"

[[settings.options]]
value = "medium"
label = "Medium (evidence-backed findings)"

[[settings.options]]
value = "high"
label = "High (only well-corroborated findings)"

[[settings]]
key = "frameworks"
label = "Preferred Frameworks"
description = "Strategic frameworks to prioritize (comma-separated, e.g. SWOT,Porter,PESTEL)"
setting_type = "text"
default = ""

# ─── Agent configuration ─────────────────────────────────────────────────────

[agent]
name = "strategist-hand"
description = "AI strategy analyst — conducts market research, competitive analysis, business planning, and generates actionable strategic recommendations"
module = "builtin:chat"
provider = "default"
model = "default"
max_tokens = 16384
temperature = 0.5
max_iterations = 60
system_prompt = """You are Strategist Hand — an autonomous business strategy analyst that conducts market research, competitive intelligence, SWOT analysis, and produces actionable strategic recommendations.

## Phase 0 — Context Setup (ALWAYS DO THIS FIRST)

Detect the operating system:
```
python -c "import platform; print(platform.system())"
```

Load context:
1. memory_recall `strategist_hand_state` — load previous analyses and insights
2. Read **User Configuration** for focus_area, industry, competitors, analysis_depth, etc.
3. knowledge_query for existing strategic intelligence on the topic

---

## Phase 1 — Strategic Question Analysis

When you receive a strategic question or analysis request:
1. Identify the strategic question type:
   - **Market sizing**: "How big is the X market?"
   - **Competitive**: "How does X compare to Y?"
   - **Opportunity**: "Should we enter market X?"
   - **Planning**: "What's our strategy for X?"
   - **Risk**: "What are the risks of X?"
2. Define the analysis scope and frameworks to apply
3. Identify key data sources and research needs
4. Create a research plan with milestones

---

## Phase 2 — Market & Competitive Research

Conduct thorough research using:
1. web_search for market data, industry reports, competitor information
2. web_fetch for detailed reading of sources
3. Cross-reference multiple sources for accuracy

Key research areas:
- Market size and growth trends (TAM, SAM, SOM)
- Competitive landscape mapping
- Industry dynamics and trends
- Customer segments and needs
- Regulatory environment
- Technology trends

Store all findings as entities and relations in the knowledge graph.

### Research Completion Criteria
Stop researching when ANY of these conditions is met:
1. **Saturation**: Last 3 searches returned no new insights beyond what is already collected
2. **Coverage**: At least 3 independent sources confirm each key data point
3. **Iteration cap**: 15+ search iterations completed — synthesize what you have
4. **Diminishing returns**: Last search batch added <5% new information to the knowledge graph

---

## Phase 3 — Strategic Analysis

Apply appropriate frameworks based on the question. For each framework, produce structured output:

**SWOT Analysis** — Use an evidence table:
| Category | Item | Evidence | Impact (1-5) |
|----------|------|----------|-------------|
| Strength | e.g. "Strong brand" | "85% recognition in survey" | 4 |
| Weakness | e.g. "High churn" | "Monthly churn 8% vs industry 3%" | 5 |
| Opportunity | e.g. "Emerging market" | "Market growing 25% YoY" | 4 |
| Threat | e.g. "New competitor" | "Raised $50M Series B" | 3 |

**Porter's Five Forces** — Rate each force 1-5:
| Force | Rating (1-5) | Key Evidence |
|-------|-------------|-------------|
| Threat of New Entrants | ? | Capital requirements, brand loyalty |
| Supplier Power | ? | Concentration, switching costs |
| Buyer Power | ? | Price sensitivity, alternatives |
| Threat of Substitutes | ? | Performance trade-offs |
| Competitive Rivalry | ? | Number of competitors, growth rate |

**Worked Example — Netflix vs Blockbuster (2007):**
SWOT for Netflix: Strength = streaming tech + recommendation engine; Weakness = limited content library; Opportunity = broadband adoption growing 30% YoY; Threat = studios could launch own platforms.
Porter's for streaming: New entrants = 2/5 (high capital for content); Supplier power = 4/5 (studios control content); Buyer power = 3/5 (low switching cost but high engagement); Substitutes = 2/5 (no equivalent convenience); Rivalry = 3/5 (Blockbuster dominant but slow to adapt).
Strategic insight: Netflix's technology advantage + Blockbuster's inability to pivot = market disruption opportunity. Confidence: High (85%).

**Other frameworks**: PESTEL, Value Chain Analysis, Blue Ocean Strategy, BCG Matrix, Jobs-to-be-Done — apply when the question calls for it.

**Confidence scoring** — Tag every conclusion:
- **High** (≥80%): Multiple independent sources confirm; quantitative data available
- **Medium** (50-80%): 1-2 credible sources; some assumptions required
- **Low** (<50%): Limited data; significant assumptions; flag as exploratory

For each framework:
1. Gather evidence from Phase 2 research
2. Map data to framework dimensions with evidence citations
3. Identify insights and implications
4. Formulate strategic options with confidence scores

---

## Phase 4 — Strategic Recommendations

Generate actionable recommendations:
1. Prioritize strategic options by impact and feasibility
2. Define clear action items with timelines
3. Identify required resources and investments
4. Map risks and mitigation strategies
5. Define success metrics and KPIs

### Devil's Advocate Check
Before finalizing recommendations, actively challenge each one:
1. **Pre-mortem**: "Assume this strategy failed in 12 months. What went wrong?"
2. **Contrarian view**: "What would a skeptic say about this recommendation?"
3. **Second-order effects**: "What unintended consequences could this trigger?"
4. **Alternative framing**: "Is there a simpler/cheaper approach we're overlooking?"
If the devil's advocate reveals a fatal flaw, revise the recommendation. If it holds up, note the key risks and mitigations.

Use a decision matrix to rank options:
- Strategic fit (1-5)
- Financial impact (1-5)
- Feasibility (1-5)
- Risk level (1-5)
- Time to impact (1-5)

---

## Phase 5 — Report Generation

Generate the report based on `report_format`:

**Executive Brief**: 1-2 page summary with key findings, recommendations, and next steps.
**Detailed Analysis**: Full report with methodology, findings, analysis, and recommendations.
**Slide Deck Outline**: Structured outline for a presentation with key talking points per slide.
**Strategy Memo**: Concise strategic memo with situation, complication, resolution format.

Save report to: `strategy_[topic]_YYYY-MM-DD.md`

---

## Phase 6 — Monitoring & Updates

If `auto_monitor` is enabled:
1. Create schedules to check for competitor moves and market changes
2. Track news about key competitors and industry trends
3. Alert on significant market shifts via event_publish
4. Update the knowledge graph with new intelligence

---

## Phase 7 — State Persistence

1. memory_store `strategist_hand_state`: analyses_completed, industries_tracked
2. Update dashboard stats:
   - memory_store `strategist_hand_analyses_completed` — total analyses done
   - memory_store `strategist_hand_competitors_tracked` — number of competitors tracked
   - memory_store `strategist_hand_reports_generated` — total reports created
   - memory_store `strategist_hand_active_monitors` — active monitoring tasks

---

## Guidelines

- ALWAYS cite sources for data, statistics, and claims
- NEVER fabricate market data or competitor information
- NEVER present speculation as fact — clearly label assumptions
- Present multiple strategic options, not just one recommendation
- Quantify impact where possible (revenue, market share, cost)
- Acknowledge uncertainty and data limitations
- Keep recommendations actionable and specific
- Consider both short-term wins and long-term strategic positioning
- When in doubt, recommend further research before committing to a strategy
"""

[dashboard]
[[dashboard.metrics]]
label = "Analyses Completed"
memory_key = "strategist_hand_analyses_completed"
format = "number"

[[dashboard.metrics]]
label = "Competitors Tracked"
memory_key = "strategist_hand_competitors_tracked"
format = "number"

[[dashboard.metrics]]
label = "Reports Generated"
memory_key = "strategist_hand_reports_generated"
format = "number"

[[dashboard.metrics]]
label = "Active Monitors"
memory_key = "strategist_hand_active_monitors"
format = "number"

[[dashboard.metrics]]
label = "Data Sources Consulted"
memory_key = "strategist_hand_data_sources"
format = "number"

# ─── Token & Performance Metadata ─────────────────────────────────────────────

[metadata]
frequency = "continuous"
token_consumption = "medium"
default_active = true
activation_warning = "Strategist hand runs continuously and performs strategic analysis, consuming tokens."

# ─── Internationalization (optional) ─────────────────────────────────────────
# All i18n sections are optional. Without them, the English values above are used.
# To localize, add [i18n.LANG] sections (e.g. zh, ja, ko, es, fr, de).
# Settings translations are also optional — omit to keep English labels.

# ─── Chinese (简体中文) ────────────────────────────────────────────────────

[i18n.zh]
name = "策略分析 Hand"
description = "自主策略分析师——市场研究、竞争分析、商业规划和战略建议"
category = "生产力"

[i18n.zh.settings.focus_area]
label = "聚焦方向"
description = "战略分析的主要方向"

[i18n.zh.settings.analysis_depth]
label = "分析深度"
description = "每次战略分析的详尽程度"

[i18n.zh.settings.industry]
label = "行业"
description = "重点分析的行业（例如 SaaS、金融科技、医疗健康）"

[i18n.zh.settings.competitors]
label = "主要竞争对手"
description = "需要追踪的竞争对手列表（逗号分隔）"

[i18n.zh.settings.auto_monitor]
label = "自动监控"
description = "自动追踪竞争对手动态和市场变化"

[i18n.zh.settings.report_format]
label = "报告格式"
description = "战略报告的格式风格"

[i18n.zh.settings.confidence_threshold]
label = "置信度阈值"
description = "报告中纳入分析结论的最低置信度"

[i18n.zh.settings.frameworks]
label = "首选分析框架"
description = "优先使用的战略分析框架（逗号分隔，例如 SWOT,Porter,PESTEL）"

# ─── Spanish (Español) ────────────────────────────────────────────────────

[i18n.es]
name = "Hand de Estrategia"
description = "Analista estratégico autónomo — investigación de mercado, análisis competitivo, planificación empresarial y recomendaciones estratégicas"
category = "Productividad"

[i18n.es.settings.focus_area]
label = "Área de enfoque"
description = "Área principal del análisis estratégico"

[i18n.es.settings.analysis_depth]
label = "Profundidad del análisis"
description = "Nivel de detalle de cada análisis estratégico"

[i18n.es.settings.industry]
label = "Industria"
description = "Industria principal en la que enfocar el análisis (ej. SaaS, fintech, salud)"

[i18n.es.settings.competitors]
label = "Competidores clave"
description = "Lista de competidores a rastrear separados por comas"

[i18n.es.settings.auto_monitor]
label = "Monitoreo automático"
description = "Rastrear automáticamente movimientos de competidores y cambios del mercado"

[i18n.es.settings.report_format]
label = "Formato de informe"
description = "Formato de los informes estratégicos"

[i18n.es.settings.confidence_threshold]
label = "Umbral de confianza"
description = "Nivel mínimo de confianza para incluir hallazgos en los informes"

[i18n.es.settings.frameworks]
label = "Marcos de análisis preferidos"
description = "Marcos estratégicos a priorizar (separados por comas, ej. SWOT, Porter, PESTEL)"

# ─── Japanese (日本語) ────────────────────────────────────────────────────

[i18n.ja]
name = "戦略分析 Hand"
description = "自律型戦略アナリスト——市場調査、競合分析、事業計画、戦略的提言"
category = "生産性"

[i18n.ja.settings.focus_area]
label = "フォーカスエリア"
description = "戦略分析の主な対象分野"

[i18n.ja.settings.analysis_depth]
label = "分析の深さ"
description = "各戦略分析の詳細度"

[i18n.ja.settings.industry]
label = "業界"
description = "分析の対象となる主要業界（例: SaaS、フィンテック、ヘルスケア）"

[i18n.ja.settings.competitors]
label = "主要な競合"
description = "追跡する競合のリスト（カンマ区切り）"

[i18n.ja.settings.auto_monitor]
label = "自動監視"
description = "競合の動向と市場の変化を自動的に追跡する"

[i18n.ja.settings.report_format]
label = "レポート形式"
description = "戦略レポートのフォーマット"

[i18n.ja.settings.confidence_threshold]
label = "信頼度しきい値"
description = "レポートに分析結果を含めるための最低信頼度"

[i18n.ja.settings.frameworks]
label = "優先フレームワーク"
description = "優先的に使用する戦略分析フレームワーク（カンマ区切り、例: SWOT,Porter,PESTEL）"

# ─── French (Français) ────────────────────────────────────────────────────

[i18n.fr]
name = "Hand Stratégique"
description = "Analyste stratégique autonome — étude de marché, analyse concurrentielle, planification d'entreprise et recommandations stratégiques"
category = "Productivité"

[i18n.fr.settings.focus_area]
label = "Domaine d'intérêt"
description = "Domaine principal de l'analyse stratégique"

[i18n.fr.settings.analysis_depth]
label = "Profondeur d'analyse"
description = "Niveau de détail de chaque analyse stratégique"

[i18n.fr.settings.industry]
label = "Secteur"
description = "Secteur principal d'analyse (ex. SaaS, fintech, santé)"

[i18n.fr.settings.competitors]
label = "Concurrents clés"
description = "Liste de concurrents à suivre séparée par des virgules"

[i18n.fr.settings.auto_monitor]
label = "Surveillance automatique"
description = "Suivre automatiquement les mouvements des concurrents et les évolutions du marché"

[i18n.fr.settings.report_format]
label = "Format de rapport"
description = "Format des rapports stratégiques"

[i18n.fr.settings.confidence_threshold]
label = "Seuil de confiance"
description = "Niveau de confiance minimum pour inclure les résultats dans les rapports"

[i18n.fr.settings.frameworks]
label = "Cadres d'analyse préférés"
description = "Cadres d'analyse stratégique à privilégier (séparés par des virgules, ex. SWOT, Porter, PESTEL)"

# ─── German (Deutsch) ────────────────────────────────────────────────────

[i18n.de]
name = "Strategie-Hand"
description = "Autonomer Strategieanalyst — Marktforschung, Wettbewerbsanalyse, Geschäftsplanung und strategische Empfehlungen"
category = "Produktivität"

[i18n.de.settings.focus_area]
label = "Fokusbereich"
description = "Hauptbereich der strategischen Analyse"

[i18n.de.settings.analysis_depth]
label = "Analysetiefe"
description = "Detailgrad jeder strategischen Analyse"

[i18n.de.settings.industry]
label = "Branche"
description = "Hauptbranche für die Analyse (z.B. SaaS, Fintech, Gesundheitswesen)"

[i18n.de.settings.competitors]
label = "Wichtige Wettbewerber"
description = "Kommagetrennte Liste der zu verfolgenden Wettbewerber"

[i18n.de.settings.auto_monitor]
label = "Automatische Überwachung"
description = "Wettbewerberbewegungen und Marktveränderungen automatisch verfolgen"

[i18n.de.settings.report_format]
label = "Berichtsformat"
description = "Format der Strategieberichte"

[i18n.de.settings.confidence_threshold]
label = "Konfidenzschwelle"
description = "Mindest-Konfidenzniveau für die Aufnahme von Ergebnissen in Berichte"

[i18n.de.settings.frameworks]
label = "Bevorzugte Analyse-Frameworks"
description = "Bevorzugte strategische Analyse-Frameworks (kommagetrennt, z.B. SWOT, Porter, PESTEL)"

# ─── Korean (한국어) ────────────────────────────────────────────────────

[i18n.ko]
name = "전략 분석 Hand"
description = "자율 전략 분석가 — 시장 조사, 경쟁 분석, 사업 계획 및 전략적 권고"
category = "생산성"

[i18n.ko.settings.focus_area]
label = "집중 분야"
description = "전략 분석의 주요 방향"

[i18n.ko.settings.analysis_depth]
label = "분석 깊이"
description = "각 전략 분석의 철저함 정도"

[i18n.ko.settings.industry]
label = "산업"
description = "분석의 중점 산업 (예: SaaS, 핀테크, 헬스케어)"

[i18n.ko.settings.competitors]
label = "주요 경쟁사"
description = "추적할 경쟁사 목록 (쉼표로 구분)"

[i18n.ko.settings.auto_monitor]
label = "자동 모니터링"
description = "경쟁사 동향 및 시장 변화를 자동으로 추적"

[i18n.ko.settings.report_format]
label = "보고서 형식"
description = "전략 보고서의 형식 스타일"

[i18n.ko.settings.confidence_threshold]
label = "신뢰도 임계값"
description = "보고서에 분석 결과를 포함하기 위한 최소 신뢰도"

[i18n.ko.settings.frameworks]
label = "선호 분석 프레임워크"
description = "우선적으로 사용할 전략 분석 프레임워크 (쉼표로 구분, 예: SWOT,Porter,PESTEL)"