# digitalrozen/ai-architect-micro-poc architecture

> Architecture diagram of the GitHub repository digitalrozen/ai-architect-micro-poc, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/digitalrozen/ai-architect-micro-poc
- Repository: https://github.com/digitalrozen/ai-architect-micro-poc

## Overview

This is a small public architecture portfolio, not a software runtime. Its user-facing path is a diagnostic, a bounded Micro-PoC, and optionally a retainer; the ADRs, scaffold, and checklist provide supporting method and governance material. The README documents the offer and links readers to the ADRs and checklist. No source excerpts were available, so relationships beyond those README references are omitted.

Main entry points: [`README.md`](https://github.com/digitalrozen/ai-architect-micro-poc/blob/main/README.md) (Portfolio overview), [`adrs/001-agent-identity-three-layers.md`](https://github.com/digitalrozen/ai-architect-micro-poc/blob/main/adrs/001-agent-identity-three-layers.md) (Agent identity ADR), [`adrs/002-tool-neutrality-decision-tree.md`](https://github.com/digitalrozen/ai-architect-micro-poc/blob/main/adrs/002-tool-neutrality-decision-tree.md) (Tool neutrality ADR), [`adrs/003-micropoc-definition-of-done.md`](https://github.com/digitalrozen/ai-architect-micro-poc/blob/main/adrs/003-micropoc-definition-of-done.md) (Micro-PoC definition ADR)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portfolio["Architecture portfolio"]
  node_readme["Portfolio overview<br/>[README.md]"]
  node_adr_identity["Agent identity ADR"]
  node_adr_neutrality["Tool neutrality ADR"]
  node_adr_definition["Micro-PoC definition ADR"]
  node_scaffold["Micro-PoC scaffold<br/>[README.md]"]
  node_governance["Agent governance checklist"]
end

subgraph group_offer["Service offer"]
  node_diagnostic["Diagnostic<br/>[README.md]"]
  node_micropoc["Micro-PoC<br/>[README.md]"]
  node_retainer["Optional retainer<br/>[README.md]"]
end

node_ceo_operator(("CEOs and operators"))

node_readme -->|"points readers to"| node_adr_identity
node_readme -->|"points readers to"| node_adr_neutrality
node_readme -->|"points readers to"| node_adr_definition
node_readme -->|"points readers to"| node_governance
node_ceo_operator -->|"engages"| node_diagnostic
node_diagnostic -->|"followed by"| node_micropoc
node_micropoc -.->|"may continue as"| node_retainer

click node_readme "https://github.com/digitalrozen/ai-architect-micro-poc/blob/main/README.md"
click node_adr_identity "https://github.com/digitalrozen/ai-architect-micro-poc/blob/main/adrs/001-agent-identity-three-layers.md"
click node_adr_neutrality "https://github.com/digitalrozen/ai-architect-micro-poc/blob/main/adrs/002-tool-neutrality-decision-tree.md"
click node_adr_definition "https://github.com/digitalrozen/ai-architect-micro-poc/blob/main/adrs/003-micropoc-definition-of-done.md"
click node_scaffold "https://github.com/digitalrozen/ai-architect-micro-poc/blob/main/scaffold/README.md"
click node_governance "https://github.com/digitalrozen/ai-architect-micro-poc/blob/main/checklists/agent-governance-posture.md"
click node_diagnostic "https://github.com/digitalrozen/ai-architect-micro-poc/blob/main/README.md"
click node_micropoc "https://github.com/digitalrozen/ai-architect-micro-poc/blob/main/README.md"
click node_retainer "https://github.com/digitalrozen/ai-architect-micro-poc/blob/main/README.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_readme,node_adr_identity,node_adr_neutrality,node_adr_definition,node_scaffold,node_governance toneBlue
class node_diagnostic,node_micropoc,node_retainer toneAmber
class node_ceo_operator toneIndigo
```

## Components

### Architecture portfolio

- [Portfolio overview](https://github.com/digitalrozen/ai-architect-micro-poc/blob/main/README.md): `README.md`
- [Agent identity ADR](https://github.com/digitalrozen/ai-architect-micro-poc/blob/main/adrs/001-agent-identity-three-layers.md): `adrs/001-agent-identity-three-layers.md`
- [Tool neutrality ADR](https://github.com/digitalrozen/ai-architect-micro-poc/blob/main/adrs/002-tool-neutrality-decision-tree.md): `adrs/002-tool-neutrality-decision-tree.md`
- [Micro-PoC definition ADR](https://github.com/digitalrozen/ai-architect-micro-poc/blob/main/adrs/003-micropoc-definition-of-done.md): `adrs/003-micropoc-definition-of-done.md`
- [Micro-PoC scaffold](https://github.com/digitalrozen/ai-architect-micro-poc/blob/main/scaffold/README.md): `scaffold/README.md`
- [Agent governance checklist](https://github.com/digitalrozen/ai-architect-micro-poc/blob/main/checklists/agent-governance-posture.md): `checklists/agent-governance-posture.md`

### Service offer

- [Diagnostic](https://github.com/digitalrozen/ai-architect-micro-poc/blob/main/README.md): `README.md`
- [Micro-PoC](https://github.com/digitalrozen/ai-architect-micro-poc/blob/main/README.md): `README.md`
- [Optional retainer](https://github.com/digitalrozen/ai-architect-micro-poc/blob/main/README.md): `README.md`

### Other components

- **CEOs and operators**

## Connections

- Portfolio overview → Agent identity ADR: points readers to (evidence: `README.md`)
- Portfolio overview → Tool neutrality ADR: points readers to (evidence: `README.md`)
- Portfolio overview → Micro-PoC definition ADR: points readers to (evidence: `README.md`)
- Portfolio overview → Agent governance checklist: points readers to (evidence: `README.md`)
- CEOs and operators → Diagnostic: engages (evidence: `README.md`)
- Diagnostic → Micro-PoC: followed by (evidence: `README.md`)
- Micro-PoC → Optional retainer: may continue as (evidence: `README.md`)
