system-prompts-and-models-o.../docs/ai-operating-model.md
2026-04-16 07:58:36 +03:00

5.4 KiB

AI operating model — decision, execution, control, data, trust

This repository follows the Master Operating Prompt (MASTER_OPERATING_PROMPT.md): a governed hybrid stack, not “agents only.”

Governance library (full index)

Document Purpose
governance/README.md Table of all governance topics
governance/planes-and-runtime.md Five planes, three layers, runtime choice
governance/approval-policy.md A / R / S, actors, Class A/B/C, evidence packs
governance/events-and-schema.md Events, JSON Schema, AsyncAPI, versioning
governance/trust-fabric.md Trust substrate, tool verification, security gate
governance/connectors-and-data-plane.md Facades, data plane, semantic metrics
governance/github-and-release.md Branch rules, CI, environments, OIDC
governance/design-and-arabic.md Design system, RTL, Arabic-first
governance/discovery-and-output-checklist.md Discovery, phasing, 20-point report, Arabic bootstrap
governance/strategic-ops-pmi.md M&A, PMI, strategic ops

Planes at a glance

Plane Owns Must not
Decision Analysis, memos, structured recommendations, scenarios Durable external commitments as narration-only
Execution Workflows, retries, idempotency, compensation, side effects Unstructured “trust me” execution
Control Policy, approvals, RBAC, secrets, promotion, audit Ad-hoc rules only in prompts
Data Operational truth, contracts, metrics definitions, lineage Duplicate conflicting metric meanings
Trust Evidence packs, tool verification, security gate, evals Claims without proof

Flow (conceptual)

flowchart LR
  subgraph decisionPlane [DecisionPlane]
    Cognition[CognitionAndMemos]
    StructuredOut[StructuredOutputs]
  end
  subgraph controlPlane [ControlPlane]
    Policy[PolicyAndApprovals]
    AuthZ[Authorization]
  end
  subgraph executionPlane [ExecutionPlane]
    Workflows[DurableWorkflows]
    SideEffects[ExternalCommitments]
  end
  subgraph dataPlane [DataPlane]
    OpsData[OperationalData]
    Contracts[ContractsAndMetrics]
  end
  subgraph trustPlane [TrustPlane]
    Evidence[EvidenceAndVerification]
    Obs[ObservabilityAndSecurityGate]
  end
  decisionPlane --> controlPlane
  controlPlane --> executionPlane
  executionPlane --> dataPlane
  trustPlane -.-> decisionPlane
  trustPlane -.-> executionPlane
  trustPlane -.-> controlPlane
  trustPlane -.-> dataPlane

Trust wraps every plane: verification, audit, telemetry, and gates apply to cognition outputs, policy decisions, workflow steps, and data mutations.

Starting path by product type

Sequence explicitly when multiple rows apply; do not mix chaotically.

Product shape Prioritize first Deep dive
SaaS Auth, billing, admin, analytics, onboarding, release github-and-release.md, connectors-and-data-plane.md
AI / agentic Provider routing, memory, orchestration, tool verification, evals, observability planes-and-runtime.md, trust-fabric.md
CRM / lead / ops Workflow safety, approvals, messaging, audit, connector facades approval-policy.md, events-and-schema.md
Strategic / corpdev Contracts, evidence packs, deterministic workflows, executive views strategic-ops-pmi.md, discovery-and-output-checklist.md

Dealix spans SaaS, agentic, CRM, and strategic modules — pick the dominant thread for the current milestone, then pull in cross-cutting trust and GitHub rules.

Dealix implementation pointers

Operating sequence for any major change

  1. Repository discovery (architecture + capability + gap + risk + trust). See governance/discovery-and-output-checklist.md.
  2. Smallest phase that proves value with tests and rollback.
  3. Evidence: tests, logs, or contract checks — as defined in the phase.
  4. Only then expand scope.

Primary policy reference: governance/approval-policy.md.