Skip to content

View Repo Live Demo

Python AWS React Native

AI Governance Unit (AIGU) β€” Continuous AI Governance OrchestrationΒΆ

TL;DR: A 9-agent LangGraph system that replaces manual AI governance checklists with a continuous orchestration loop. Projects flow through a structured lifecycle β€” Intake β†’ Risk β†’ POC β†’ Pilot β†’ Librarian β†’ Gatekeeper β†’ Production β†’ Handover β€” with specialized Amazon Nova agents handling each stage, automatic delta detection, and a universal support overlay at every step.

Stack: Python β€’ LangGraph β€’ Amazon Nova (Pro/Lite) β€’ AWS Bedrock β€’ AWS Lambda β€’ DynamoDB β€’ S3 β€’ React Native β€’ Expo β€’ LangFuse


✨ Features¢

  • 🧠 9-Agent Brain - Each lifecycle stage has a dedicated agent with focused responsibilities; no monolithic prompt
  • ⚑ Dual Paths - Hero capabilities fast-track through an Accelerator path (skip POC); New capabilities follow the full Standard path with CAF approval
  • πŸ“Š 15% Delta Threshold - Production changes are auto-analysed; updates exceeding 15% trigger full GIGC re-approval automatically
  • πŸ”„ State-Loop Architecture - React Native frontend is a "dumb" terminal; all state lives in DynamoDB, managed by LangGraph
  • πŸ›‘οΈ Universal Support Overlay - A read-only Support & Insights agent is available at every stage for status queries and "why" explanations
  • πŸ“‹ Artifact Management - Governance Librarian validates required artifacts by risk level and prevents duplication via automated audits
  • πŸ” LangFuse Tracing - Full prompt management and observability across all agent invocations
  • πŸ§ͺ TDD Lifecycle Simulations - Pytest-driven end-to-end lifecycle tests covering all paths and edge cases

🧠 Architecture¢

graph TB
    subgraph Client_Layer
        UI[React Native / A2UI\nDumb terminal]
    end

    subgraph Logic_Layer
        Lambda[AWS Lambda\nAPI Handler]
        Graph[LangGraph\nState Machine]
    end

    subgraph Agent_Brain
        Intake[1. Intake Orchestrator\nRoute: Accelerator / Standard / Stop]
        Risk[4. Risk & Triage\nSLA: 3 / 7 / 10 days]
        POC[2. POC Agent\nNew capabilities only]
        Pilot[3. Pilot Agent]
        Lib[5. Governance Librarian\nArtifact validation]
        Gate[6. Gatekeeper\nGIGC admin approvals]
        Prod[7. Production Agent\n15% delta check]
        Handover[8. Handover Agent\nIRIS / LCT / RTB tasks]
        Support[9. Support & Insights\nRead-only, always available]
    end

    subgraph AWS
        Bedrock[[Amazon Bedrock\nNova Pro / Lite]]
        Dynamo[(DynamoDB\nGlobal State + Checkpoints)]
        S3[(S3\nArtifacts)]
        LF[[LangFuse\nTracing]]
    end

    UI <-->|A2UI protocol| Lambda
    Lambda --> Graph
    Graph --> Intake --> Risk --> Lib --> Gate --> Prod --> Handover
    Intake -->|New capability| POC --> Pilot --> Risk
    Gate -->|Blocked| Support
    Prod -->|Delta >15%| Gate
    Graph <--> Bedrock & Dynamo & S3 & LF

🎯 What Makes This Special¢

Governance as a State Machine, Not a SpreadsheetΒΆ

Traditional AI governance is checklists, email chains, and manual sign-offs. AIGU models the entire lifecycle as a LangGraph state machine. Every transition β€” approval, rejection, delta re-review β€” is a graph edge. Stage-specific agents run in sequence; the Support agent is always available as a side channel. The governance process becomes auditable, automatable, and queryable.

Delta-Driven Re-ApprovalΒΆ

When a production AI system changes, most governance processes require a full manual re-review by default. AIGU's Production agent computes the delta between the current and prior submission. Changes under 15% proceed without re-approval; changes over 15% automatically re-route through the Gatekeeper. The threshold is configurable and the logic is transparent.

Hero vs. New PathsΒΆ

Not all AI capabilities need the same scrutiny. "Hero" capabilities (proven patterns within existing guardrails) skip the POC stage entirely and fast-track to Pilot. "New" capabilities follow the full Standard path including CAF approval. The Intake agent classifies the path from the initial submission; humans only intervene at defined gates.


πŸš€ Technical HighlightsΒΆ

LangGraph OrchestrationΒΆ

  • State machine: aigu/graph.py β€” a compiled LangGraph graph with conditional edges for path routing
  • State persistence: DynamoDB-backed LangGraph checkpoints for resumable sessions
  • Agent dispatch: each agent in aigu/agents/ receives the full state, acts on its slice, and returns a patch

Amazon Nova via BedrockΒΆ

  • Nova Pro: used for high-stakes decisions (risk classification, gatekeeper review, production delta analysis)
  • Nova Lite: used for lower-stakes parsing (intake extraction, librarian checks, support queries)
  • LangFuse: all prompts versioned and served at runtime; traces every invocation for debugging

Frontend (React Native / A2UI)ΒΆ

  • Pure state-renderer: the UI has no business logic; it renders whichever A2UI component tree the Lambda returns
  • expo start --web for browser preview during development

DeploymentΒΆ

  • ./aigu_manager.sh deploy β€” full stack via CloudFormation (Lambda + DynamoDB + S3 + IAM)
  • ./aigu_manager.sh teardown β€” clean removal of all AWS resources
  • pytest tests/simulate_full_lifecycle.py β€” end-to-end lifecycle simulation (no AWS required for unit stages)

πŸ“Š Key MetricsΒΆ

  • Agents: 9 specialised agents covering the full AI project lifecycle
  • Lifecycle stages: 8 stages (Intake β†’ Handover), 2 paths (Accelerator / Standard)
  • Delta threshold: configurable, default 15% β€” triggers automatic GIGC re-approval
  • SLA options: 3 / 7 / 10 days, risk-based assignment by Risk & Triage agent

This project demonstrates multi-agent orchestration for a real enterprise problem domain: replacing fragmented governance checklists with a continuous, auditable, agent-driven workflow.