mirror of
https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools.git
synced 2026-06-18 15:29:36 +00:00
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
136 lines
4.0 KiB
Markdown
136 lines
4.0 KiB
Markdown
# Expansion OS — Geographic & Vertical Growth
|
|
|
|
> **Parent**: [`MASTER_OPERATING_PROMPT.md`](../../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) |
|