system-prompts-and-models-o.../salesflow-saas/docs/governance/expansion-os.md
Claude a319feb6d7
feat(dealix): complete Tier-1 Sovereign Enterprise Growth OS
Governance layer (14 docs):
- MASTER_OPERATING_PROMPT.md — operating constitution (five planes, six tracks, policy classes)
- docs/ai-operating-model.md — five-plane architecture (Decision/Execution/Trust/Data/Operating)
- docs/dealix-six-tracks.md — six strategic tracks (Revenue/Intelligence/Compliance/Expansion/Operations/Trust)
- docs/governance/execution-fabric.md — OpenClaw execution plane deep dive
- docs/governance/trust-fabric.md — trust plane with contradiction engine + evidence packs
- docs/governance/saudi-compliance-and-ai-governance.md — PDPL/ZATCA/SDAIA/NCA live controls
- docs/governance/technology-radar-tier1.md — Core/Strong/Pilot/Watch/Hold classification
- docs/governance/partnership-os.md — alliance lifecycle management
- docs/governance/ma-os.md — M&A corporate development lifecycle
- docs/governance/expansion-os.md — geographic and vertical growth
- docs/governance/pmi-os.md — post-merger integration framework
- docs/governance/executive-board-os.md — executive decision surfaces
- docs/execution-matrix-90d-tier1.md — 90-day sprint execution plan
- docs/adr/0001-tier1-execution-policy-spikes.md — 8 architectural decisions

Backend (3 models, 6 services, 8 API routes):
- Contradiction Engine — detect/track system conflicts
- Evidence Pack System — tamper-evident audit proof with SHA256
- Saudi Compliance Matrix — live PDPL/ZATCA/SDAIA/NCA controls
- Executive Room — unified executive decision surface
- Connector Governance — integration health monitoring
- Model Routing Dashboard — LLM provider metrics
- Forecast Control Center — actual vs forecast across tracks
- Approval Center — enhanced approval queue with SLA

Frontend (9 components):
- Executive Room, Evidence Pack Viewer, Approval Center
- Connector Governance Board, Saudi Compliance Dashboard
- Actual vs Forecast Dashboard, Risk Heatmap
- Policy Violations Board, Partner Pipeline Board

Tooling:
- scripts/architecture_brief.py — preflight validation (40/40 checks pass)
- Updated CLAUDE.md and AGENTS.md with governance references

https://claude.ai/code/session_01W1rJthWDkasijTdXCfxVHs
2026-04-16 12:48:13 +00:00

4.0 KiB

Expansion OS — Geographic & Vertical Growth

Parent: MASTER_OPERATING_PROMPT.md
Plane: Decision + Execution | Tracks: Expansion, Revenue
Version: 1.0 | Status: Canonical


Overview

The Expansion OS manages Dealix's growth into new geographies and industry verticals. Every market launch is a Class B action with C-Level approval and mandatory stop-loss logic.


Expansion Framework

SCAN → PRIORITIZE → READY → LAUNCH (Canary) → SCALE → MONITOR

Phase 1: Scan

  • AI Role: Market intelligence, competitive analysis
  • Input: Macro indicators, sector size, regulatory landscape
  • Output: Market opportunity matrix

Phase 2: Prioritize

  • Criteria: Market size, regulatory complexity, Arabic support needs, competitive density
  • Output: Ranked expansion targets

Phase 3: Ready

  • Compliance: Regulatory readiness by market
  • Localization: Dialect adaptation, pricing, channel strategy
  • GTM: Go-to-market plan with ICP per market
  • Output: Market readiness checklist

Phase 4: Launch (Canary)

  • Method: Canary launch — limited tenant cohort
  • Stop-loss: Automated triggers if metrics below threshold
  • Output: Canary results report

Phase 5: Scale

  • Criteria: Canary success metrics met
  • Action: Open market to all tenants
  • Output: Market GA announcement

Phase 6: Monitor

  • Ongoing: Actual vs forecast per market
  • Triggers: Expansion, contraction, or exit decisions
  • Output: Market health dashboard

Geographic Expansion Path

Phase 1: Saudi Arabia (Current)

City Status Priority
Riyadh Live Primary
Jeddah Live Primary
Dammam Ready High
Other cities Planned Medium

Phase 2: GCC Markets

Market Complexity Arabic Dialect Target
UAE Medium Gulf/MSA 2027 H1
Bahrain Low Gulf 2027 H1
Kuwait Medium Gulf 2027 H2
Qatar Medium Gulf 2027 H2
Oman Low Gulf 2028

Phase 3: Broader MENA

Market Complexity Dialect Target
Egypt High Egyptian 2028
Jordan Medium Levantine 2028
Morocco High Maghrebi/French 2029

Vertical Expansion

Current Verticals (Live)

  • Real Estate — seeds/realestate_template.json
  • Healthcare — seeds/healthcare_template.json
  • Retail — seeds/retail_template.json
  • Contracting — seeds/contracting_template.json
  • Education — seeds/education_template.json

Target Verticals

Vertical Priority Regulatory Complexity
Financial Services High Very High (SAMA)
Automotive High Medium
Legal Medium High
Hospitality Medium Low
Government High Very High

Dialect Handling

Dialect Code Supported Service
Saudi saudi Live ai/saudi_dialect.py
Gulf gulf Live ai/arabic_nlp.py
MSA msa Live ai/arabic_nlp.py
Egyptian egyptian Planned
Levantine levantine Planned
Maghrebi maghrebi Planned

Stop-Loss Logic

Metric Threshold Action
Canary conversion rate <5% after 30 days Pause expansion
Customer complaints >10% rate Investigate
Revenue vs forecast <50% after 60 days Review / exit
Compliance violations Any critical Halt immediately
Churn rate >20% monthly Pause acquisition

Code Mapping

Component File
Territory Manager services/territory_manager.py
Feature Flags services/feature_flags.py
Canary Context openclaw/canary_context.py
Industry Templates seeds/
Sector Assets models/knowledge.py (SectorAsset)
Presentations presentations/ (11 sectors)