Skip to content

joy7758/digital-biosphere-architecture

Repository files navigation

English | 中文

Digital Biosphere Architecture

This repository is the canonical architecture hub for the Digital Biosphere Architecture.

Use it for the system view, repository boundaries, and cross-repo navigation. It is the architecture entry, not the implementation entry.

Start here

Five-layer map

Layer Repository
Persona Layer persona-object-protocol
Interaction Layer agent-intent-protocol
Governance Layer token-governor
Execution Integrity Layer fdo-kernel-mvk
Audit Evidence Layer aro-audit

What this repo is not

  • not the concrete evidence implementation
  • not the walkthrough demo
  • not the audit control plane

Canonical Stack

Digital Biosphere Architecture

Layers:

  1. Persona Layer Implementation: POP (persona-object-protocol)
  2. Interaction Layer Implementation: AIP
  3. Governance Layer Implementation: Token Governor
  4. Execution Integrity Layer Implementation: MVK
  5. Audit Evidence Layer Implementation: ARO-Audit

Overview

The five-layer stack explains how autonomous AI systems can be read through:

  • identity
  • interaction
  • governance
  • execution integrity
  • audit evidence

Architecture Diagram

flowchart TB
    DBA["Digital Biosphere Architecture"]

    Persona["Persona Layer<br>POP / persona-object-protocol"]
    Interaction["Interaction Layer<br>AIP"]
    Governance["Governance Layer<br>Token Governor"]
    Execution["Execution Integrity Layer<br>MVK"]
    Audit["Audit Evidence Layer<br>ARO-Audit"]

    DBA --> Persona --> Interaction --> Governance --> Execution --> Audit
Loading

Five-layer map

  1. Persona Layer -> persona-object-protocol
  2. Interaction Layer -> agent-intent-protocol
  3. Governance Layer -> token-governor
  4. Execution Integrity Layer -> fdo-kernel-mvk
  5. Audit Evidence Layer -> aro-audit

agent-evidence is the concrete execution-evidence entry for packaging runtime execution into offline-verifiable evidence bundles across the execution-to-audit handoff.

FDO Proposal Entry

See docs/fdo-profile-proposal-entry.md

Terminology Alignment

See docs/fdo-terminology-alignment.md

Minimal FDO Crosswalk

See docs/minimal-fdo-crosswalk.md

Execution Evidence Layer Position

See docs/execution-evidence-layer-position.md

Vienna Poster Talking Points

See docs/vienna-poster-talking-points.md

Vienna Scripts

Reference Implementations

Persona Layer

https://github.com/joy7758/persona-object-protocol

Governance Layer

https://github.com/joy7758/token-governor

Execution Integrity Layer

https://github.com/joy7758/fdo-kernel-mvk

Concrete Execution-Evidence Entry

https://github.com/joy7758/agent-evidence

Audit Evidence Layer

https://github.com/joy7758/aro-audit

Canonical Navigation

Why this stack exists

  • Persona alone is not enough because identity does not declare task semantics or runtime requests.
  • Interaction must remain separate because intent, action, and result objects should not be collapsed into persona objects or audit receipts.
  • Governance must precede execution claims because runtime boundaries need to be explicit before behavior can be reviewed.
  • Execution integrity matters because runtime claims need checkable evidence about what actually happened.
  • Audit evidence must be exportable because outside reviewers need portable artifacts instead of internal-only assertions.

Start in 5 Minutes

Layer Notes

Persona Layer

Portable persona objects and identity attachment across tools, runtimes, and interactions.

Interaction Layer

Machine-readable intent, action, and result objects for agent-to-agent and agent-to-runtime coordination.

Governance Layer

Policy, permissions, budget, and runtime constraints that determine what a system is allowed to do.

Execution Integrity Layer

Runtime truth, integrity checks, and minimal verification surfaces for execution claims. MVK belongs here as execution integrity work, not as a separate parallel architecture axis.

Audit Evidence Layer

Evidence bundles, exportable records, and reviewable audit artifacts for governance and conformance workflows.

Current Hardening Priorities

Architecture Whitepaper

Download: docs/governance_architecture_whitepaper.pdf

Citation

Suggested citation:

joy7758. Governance Architecture for Autonomous AI Agents: Digital Biosphere Architecture Whitepaper. GitHub, 2026.

Documents

Status

  • narrative hub for the canonical five-layer architecture stack
  • working draft
  • ecosystem alignment in progress

About

Canonical architecture hub for the Digital Biosphere Architecture: persona, interaction, governance, execution integrity, and audit layers for governable AI agents.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors