Skip to content

Architecture & Flows

High-level design of the AI Hub: how components connect, how data flows between them, and how the repository maintains itself over time.

Contents

Document What it covers
Component Map Full inventory of services and their relationships — the definitive "what talks to what" map
Automation Flows Detailed sequence and data-flow diagrams for key automation workflows
Infrastructure Hardware topology, network layout, and resource allocation decisions
SSH Execution Patterns Secure orchestration of remote commands across TrueNAS, Pi, and MacBook
Automated Contributions How Google Jules, digest workflows, and quality gates keep the repo self-improving
Multi-Agent KnowledgeOps Governance contract, role model, and CI gates for scalable multi-agent documentation growth
Prompt Catalogue Reference library of production prompts used across automation workflows

System at a Glance

flowchart LR
    subgraph Ingest
        A[Daily digest] --> B[Digest-to-intake bridge]
        B --> C[docs/new-sources/]
    end
    subgraph Automate
        C --> D[Jules maintenance issue]
        D --> E[Jules PR]
    end
    subgraph Gate
        E --> F[Quality gates\ndocs · catalog · links · intake]
        F --> G[Main branch]
    end
    subgraph Serve
        G --> H[GitHub Pages\nai.riera.co.uk]
    end

Sources / References

Contribution Metadata

  • Last reviewed: 2026-03-15
  • Confidence: high