System-of-Systems Architecture

The whole-ecosystem view: how ventures, repos, and shared services relate. Diagrams are Mermaid, embedded so GitHub renders them. Individual repo/venture diagrams live in their digests; the deep platform view is in Intelligence Platform architecture; this page is the system of systems. For the executive framing see the Portfolio Overview; for the rules governing it all see Architecture Principles.

Framing (from senior-architect): the ecosystem is described at four altitudes — layered/system context, container/service, layer grouping, and cross-repo dependencies.

Realization key: ✅ operational · 🔶 partial/planned · 🧭 vision. Labels are evidence-based; nothing un-evidenced is asserted (Principle 8).

1. System context (layered)

graph TD
    Azwaan([Azwaan / Founder]) --> Eco
    SRC((Knowledge estate · captures · signals)) --> Eco
    subgraph Eco["Azwaan AI Venture Ecosystem"]
        direction TB
        L6[6 · Customer-facing 🧭] --> Market
        L5[5 · Ventures 🧭<br/>Inexis Digital · Consulting · Inbound Lanka · City Retreats] --> L6
        L4[4 · Applications & Agents 🔶<br/>leadplatform · outreachagent] --> L5
        L3[3 · Intelligence Products 🔶<br/>intelproducts] --> L4
        L2[2 · Intelligence Platform 🔶<br/>PersonalOps/FIP · website-intelligence-lab] --> L3
        L1[1 · Shared Skills ✅<br/>169 skills] --> L2
    end
    Eco --> Market((Customers / Market))
    Ext[External: Anthropic · Supabase · Cloudflare · WordPress] --- Eco
    classDef live fill:#1f7a1f,color:#fff;
    class L1 live;

2. Container / service map

graph TD
    subgraph L1["Shared Skills ✅"]
        SS[169 skills]
    end
    subgraph L2["Intelligence Platform 🔶"]
        FIP["PersonalOps/FIP<br/>TanStack UI + Supabase + harvest"]
        LAB["website-intelligence-lab<br/>Docker · Caddy · WP Multisite + runs"]
    end
    IPR[("intelproducts 🔶<br/>versioned packs + consumer skills")]
    subgraph L4["Applications & Agents 🔶"]
        LEAD["leadplatform<br/>Next.js + CF Worker/D1"]
        OA["outreachagent<br/>COP recommendations"]
    end
    PORTAL["portfolio-portal<br/>docs/governance"]

    SS -->|built with| PORTAL
    SS -.-> FIP & LAB & IPR
    FIP --> IPR
    IPR -->|pinned submodule| LEAD
    IPR --> OA
    LEAD & OA --> VEN[Ventures 🧭]

3. Layer / system map

graph LR
    subgraph LYR1[L1 · Shared Skills]
        R1[shared-skills]
    end
    subgraph LYR2[L2 · Intelligence Platform]
        R2[personalops]
        R3[website-intelligence-lab]
    end
    subgraph LYR3[L3 · Intelligence Products]
        R4[intelproducts]
    end
    subgraph LYR4[L4 · Applications & Agents]
        R5[leadplatform]
        R6[outreachagent]
    end
    subgraph DOCS[Docs / Governance]
        RP[portfolio-portal]
    end
    R1 --> RP
    R1 -.-> R2 & R3 & R4
    R2 --> R4
    R4 --> R5 & R6
    R5 & R6 -.-> LYR5[L5 · Ventures 🧭]

4. System Dependency Map (cross-repo)

Solid = evidenced dependency; dashed = planned/future or lateral capability.

graph TD
    HARNESS[AI Harness / Agent SDK] -->|routes to| SS[shared-skills]
    SS -->|skills used to build| PORTAL[portfolio-portal]
    SS -.capability.-> FIP[personalops/FIP]
    SS -.capability.-> LAB[website-intelligence-lab]
    SS -.builder+consumer skills.-> IPR[intelproducts]

    FIP -->|authors & publishes packs| IPR
    IPR -->|pinned git submodule| LEAD[leadplatform]
    IPR -->|consumer skills| OA[outreachagent]
    IPR -->|website-assessment pack = scoring truth| INX[inexisstudios<br/>assessment engine]
    INX -->|/api/assessments → COP| OA
    INX -.evaluated against.-> LAB
    LAB -.references external knowledge by version.-> KNOW[(external knowledge)]

    PORTAL -.will be automated by.-> ORCH[[portfolio-portal-orchestrator]]
    ORCH -.reads.-> SS & FIP & LAB & IPR

    classDef future fill:#eee,stroke-dasharray:4 3;
    class ORCH future;

Evidenced dependencies

portfolio-portal depends on shared-skills (built with its skills).
personalops/FIP produces intelproducts (authors packs via builder skills).
inexisstudios (assessment engine) depends on the intelproducts website-assessment pack (scoring truth).
outreachagent depends on inexisstudios (/api/assessments → COP) and intelproducts (outreach-messaging skills).
leadplatform depends on intelproducts (pinned git submodule, read-only contract).
inexisstudios is evaluated against website-intelligence-lab (harness/runs — Phase-1 seed).
personalops, website-intelligence-lab, intelproducts consume shared-skills capability.

Sibling, non-dependent (recorded): personalops/FIP and website-intelligence-lab have no direct code coupling — related only conceptually (knowledge referenced, never owned; Principle 3).

Planned / not-built: the portfolio-portal-orchestrator (spec only); external website engines (run against the lab); the Hermes learning loop; OpenClaw pack consumption. “Estate generation” is not a real subsystem (see Intelligence Platform).

Node → digest index

Node ID	Kind	Digest
`shared-skills`	repo (L1)	repos/shared-skills
`personalops`	repo (L2)	repos/personalops
`website-intelligence-lab`	repo (L2)	repos/website-intelligence-lab
`intelproducts`	repo (L3)	repos/intelproducts
`inexisstudios`	repo (L4) — assessment engine	capability: Website Assessment
`leadplatform`	repo (L4)	not yet processed (registry row)
`outreachagent`	repo (L4)	not yet processed (registry row)
`intelligence-platform`	system	ventures/intelligence-platform
`shared-skills` (layer)	system	ventures/shared-skills
`portfolio-portal`	repo (this repo)	README