system-prompts-and-models-o.../salesflow-saas/docs/governance/partnership-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

111 lines
3.7 KiB
Markdown

# Partnership OS — Alliance Lifecycle Management
> **Parent**: [`MASTER_OPERATING_PROMPT.md`](../../MASTER_OPERATING_PROMPT.md)
> **Plane**: Decision + Execution | **Tracks**: Expansion, Revenue
> **Version**: 1.0 | **Status**: Canonical
---
## Overview
The Partnership OS manages the full lifecycle of strategic alliances — from scouting to co-sell optimization. Every partnership commitment is a Class B action requiring human approval.
---
## Partnership Lifecycle
```
SCOUT → EVALUATE → NEGOTIATE → ONBOARD → MANAGE → OPTIMIZE → RENEW/EXIT
```
### Phase 1: Scout
- **Input**: Market signals, ecosystem gaps, customer requests
- **AI Role**: `ecosystem_mapper.py` identifies potential partners
- **Output**: Partner prospect list with strategic fit scores
### Phase 2: Evaluate
- **Input**: Partner prospect list
- **AI Role**: `deal_matcher.py` scores strategic fit
- **Output**: `PartnerFitScoreCard` (structured)
### Phase 3: Negotiate
- **Input**: Approved partner candidates
- **AI Role**: `deal_negotiator.py` drafts term proposals
- **Human Role**: Reviews and approves terms (Class B)
- **Output**: Term sheet (versioned)
### Phase 4: Onboard
- **Input**: Signed agreement
- **Execution**: Activation playbooks, system integration, training
- **Output**: Partner activated in system
### Phase 5: Manage
- **Input**: Live partnership
- **Monitoring**: Partner scorecards, contribution margin, health signals
- **Output**: Monthly partner performance report
### Phase 6: Optimize
- **Input**: Performance data
- **AI Role**: Co-sell/co-market recommendations
- **Output**: Optimization playbook
---
## Partnership Types
| Type | Description | Approval Level |
|------|------------|---------------|
| Referral | Lead exchange, commission-based | Manager |
| Distribution | Resale rights, channel partner | Director |
| Technology | API integration, co-development | VP |
| Strategic | Joint ventures, co-investment | C-Level |
| Government | Public sector partnerships | C-Level + Legal |
---
## Code Mapping
| Component | File | Purpose |
|-----------|------|---------|
| Ecosystem Mapper | `services/strategic_deals/ecosystem_mapper.py` | Partner discovery |
| Deal Matcher | `services/strategic_deals/deal_matcher.py` | Fit scoring |
| Deal Negotiator | `services/strategic_deals/deal_negotiator.py` | Term drafting |
| Deal Room | `services/strategic_deals/deal_room.py` | Negotiation workspace |
| Channel Compliance | `services/strategic_deals/channel_compliance.py` | Channel governance |
| ROI Engine | `services/strategic_deals/roi_engine.py` | Partnership ROI |
| Strategic Deal Model | `models/strategic_deal.py` | Data model |
| Strategic Deals API | `api/v1/strategic_deals.py` | API endpoints |
---
## Structured Outputs
- `PartnerFitScoreCard` — strategic alignment, revenue potential, risk assessment
- `PartnerTermSheet` — economics, obligations, SLAs, exit clauses
- `PartnerScorecard` — monthly performance, contribution margin, health
- `PartnerActivationChecklist` — integration steps, training, go-live criteria
---
## GCC-Specific Considerations
| Factor | Requirement |
|--------|------------|
| Saudization | Partners must meet Saudization quotas for joint operations |
| Local partner mandate | Some sectors require Saudi partner (>51% ownership) |
| CR verification | Commercial Registration must be verified before activation |
| Arabic agreements | All partnership agreements must be available in Arabic |
| PDPL data sharing | Data sharing between partners requires PDPL consent |
---
## KPIs
| Metric | Target |
|--------|--------|
| Partner-sourced revenue | >15% of total |
| Time to activate (days) | <30 |
| Partner satisfaction score | >4.0/5.0 |
| Co-sell deal conversion | >25% |
| Partner churn rate | <10% annual |