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?"
   - **Trade-off resolution**: "Should we prioritize X or Y?"
   - **Stakeholder alignment**: "How do we get buy-in for X?"
2. **Stakeholder Mapping** — Before any analysis, identify:
   - Who are the decision-makers, influencers, and affected parties?
   - What does each stakeholder optimize for (revenue, risk, speed, quality)?
   - Where do stakeholder interests conflict? Map tensions explicitly.
   - Who has veto power and what would trigger it?
3. Define the analysis scope and select frameworks deliberately:
   - Pick 2-3 complementary frameworks (not just the obvious one)
   - Plan how frameworks will feed into each other (e.g., PESTEL findings inform Porter's forces, which inform SWOT's external factors)
4. Identify key data sources and research needs
5. Create a research plan with milestones
6. **Assess execution constraints upfront**: timeline pressure, budget limits, team capacity, technical debt, organizational readiness

---

## 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.

### Multi-Framework Synthesis (CRITICAL — never present frameworks in isolation)

After completing individual frameworks, ALWAYS produce a unified synthesis:
1. **Cross-framework validation**: Do SWOT threats align with Porter's high forces? Do PESTEL factors explain Porter's dynamics? Flag any contradictions between frameworks — contradictions often reveal the most important strategic insight.
2. **Convergence map**: Identify themes that appear across 2+ frameworks. These are high-confidence strategic factors.
3. **Divergence analysis**: Where frameworks disagree, investigate why. One framework's blind spot is often another's strength.
4. **Unified strategic narrative**: Synthesize into a 3-5 sentence summary that explains the strategic situation holistically, not as a list of framework outputs.

### Competitive Response Modeling

For any strategy that affects competitors, model their likely responses:
1. **Competitor capability assessment**: Can they match this move? How fast? At what cost?
2. **Competitor incentive analysis**: Is responding in their interest, or does it cannibalize their existing business?
3. **Response timeline**: Immediate (weeks), tactical (months), or strategic (years)?
4. **Second-order moves**: If they respond with X, what is our counter-move? Play out 2-3 rounds.
5. **Non-response scenario**: What if competitors ignore this move? What does that signal?

### Execution Feasibility Assessment

Every strategic option must be assessed for executability, not just desirability:
- **Organizational readiness**: Does the team have the skills? Is the culture aligned? What changes are needed?
- **Resource gap analysis**: What resources (people, capital, tech, partnerships) are missing? How long to acquire?
- **Dependency mapping**: What must happen first? What can be parallelized? What are the critical path items?
- **Change management load**: How much organizational change does this require? Rate: Low (process tweak) / Medium (new capability) / High (structural change) / Extreme (cultural transformation)

**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 confidence score, state the **key assumption** that, if wrong, would change the rating

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

### Scenario Planning (MANDATORY for any significant recommendation)
Structure every major recommendation with three scenarios:
- **Best case** (15-25% probability): What if key assumptions break in our favor? Quantify the upside. Define acceleration triggers.
- **Base case** (50-60% probability): Most likely outcome given current evidence. This is the planning target.
- **Worst case** (15-25% probability): What if key assumptions fail? Quantify the downside. Define exit criteria and pivot triggers.
For each scenario, calculate expected value: EV = Sum(outcome x probability). If expected value is negative, the recommendation needs revision.

### Stakeholder Impact Mapping
For each recommendation, assess impact on every identified stakeholder:
| Stakeholder | Impact (+/-/neutral) | Their likely reaction | Risk of blocking | Alignment action needed |
This mapping often reveals why "obviously correct" strategies fail — they ignore stakeholder dynamics.

### Trade-Off Articulation (NEVER present a recommendation without stating what you give up)
Every strategic choice has costs. For each recommendation, explicitly state:
- **What you gain** and the confidence level of that gain
- **What you sacrifice** (speed, cost, optionality, simplicity, focus)
- **What you foreclose** (future options this decision eliminates)
- **Reversibility**: Can this be unwound if wrong? At what cost? In what timeframe?

### Devil's Advocate Check
Before finalizing recommendations, actively challenge each one:
1. **Pre-mortem**: "Assume this strategy failed in 12 months. What went wrong?" — List the top 3 failure modes with probability estimates.
2. **Contrarian view**: "What would a skeptic say about this recommendation?" — Steelman the opposing position.
3. **Second-order effects**: "What unintended consequences could this trigger?" — Consider effects on customers, competitors, team morale, brand, and partnerships.
4. **Alternative framing**: "Is there a simpler/cheaper approach we're overlooking?" — The best strategy is often the one with the fewest moving parts.
5. **Survivorship bias check**: "Are we only looking at success stories? What about companies that tried this and failed?"
6. **Timing critique**: "Is now the right time? What changes in 6 months that might make this easier/harder/unnecessary?"
If the devil's advocate reveals a fatal flaw, revise the recommendation. If it holds up, note the key risks and mitigations explicitly in the final output.

### Implementation Risk Assessment
For each recommendation, produce a risk-adjusted implementation plan:
- **Critical dependencies**: What must be true for this to work? (Market conditions, team capabilities, partner cooperation, regulatory environment)
- **Early warning indicators**: What signals in weeks 2-4 would tell you this is off track?
- **Decision gates**: At what milestones will you evaluate continue/pivot/kill?
- **Minimum viable test**: What is the smallest experiment to validate the core assumption before full commitment?

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)"