# ai-architect-studio/agentic-architecture-field-guide architecture

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

- Interactive diagram: https://gitdiagram.com/ai-architect-studio/agentic-architecture-field-guide
- Repository: https://github.com/ai-architect-studio/agentic-architecture-field-guide

## Overview

This repository is a vendor-neutral agent-architecture field guide and client-delivery kit, not an agent runtime. A reader moves from runtime and reference-architecture choices through trust and deployment decisions, then documents a client rollout and reviews declared evidence. The offline workbench, planning report, release-evidence checker, and deterministic support-agent reference provide practical artifacts. The README documents the kit’s main links and capabilities; unsampled documentation and workbench internals are represented only at their known paths, without inferred implementation-level connections.

Main entry points: [`START-HERE.md`](https://github.com/ai-architect-studio/agentic-architecture-field-guide/blob/main/START-HERE.md) (Start guide), [`docs/runtime-decision-matrix.md`](https://github.com/ai-architect-studio/agentic-architecture-field-guide/blob/main/docs/runtime-decision-matrix.md) (Runtime choices), [`docs/reference-architectures.md`](https://github.com/ai-architect-studio/agentic-architecture-field-guide/blob/main/docs/reference-architectures.md) (Reference patterns), [`docs/security-boundaries.md`](https://github.com/ai-architect-studio/agentic-architecture-field-guide/blob/main/docs/security-boundaries.md) (Trust boundaries)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guide["Architecture Guide"]
  node_start["Start guide<br/>[START-HERE.md]"]
  node_runtime["Runtime choices"]
  node_patterns["Reference patterns"]
  node_trust["Trust boundaries"]
  node_operating["Operating models"]
  node_machine["Local audit"]
end

subgraph group_delivery["Client Delivery"]
  node_proof["Architecture proof"]
  node_templates["Delivery templates<br/>[README.md]"]
  node_adaptation["Adaptation lab"]
  node_workbench["Delivery workbench<br/>[index.html]"]
end

subgraph group_tools["Offline Tools"]
  node_decision_report["Decision report"]
  node_evidence_check["Evidence checker"]
end

subgraph group_examples["Runnable Examples"]
  node_support_agent["Support agent<br/>[agent.mjs]"]
  node_support_rag["Support RAG<br/>[README.md]"]
  node_consultant_brief["Consultant brief<br/>[README.md]"]
end

node_reader(("Architect / operator"))

node_reader -->|"begins with"| node_start
node_start -->|"opens workbench"| node_workbench
node_start -->|"runs reference"| node_support_agent
node_start -->|"uses templates"| node_templates
node_start -->|"follows lab"| node_adaptation
node_reader -->|"selects runtime"| node_runtime
node_reader -->|"reviews patterns"| node_patterns
node_reader -->|"reviews boundaries"| node_trust
node_reader -->|"designs workflow"| node_operating
node_reader -->|"audits machine"| node_machine
node_reader -->|"documents rollout"| node_proof
node_reader -->|"reviews decision"| node_decision_report
node_reader -->|"checks evidence"| node_evidence_check
node_reader -->|"reviews handover"| node_support_rag
node_reader -->|"studies example"| node_consultant_brief

click node_start "https://github.com/ai-architect-studio/agentic-architecture-field-guide/blob/main/START-HERE.md"
click node_runtime "https://github.com/ai-architect-studio/agentic-architecture-field-guide/blob/main/docs/runtime-decision-matrix.md"
click node_patterns "https://github.com/ai-architect-studio/agentic-architecture-field-guide/blob/main/docs/reference-architectures.md"
click node_trust "https://github.com/ai-architect-studio/agentic-architecture-field-guide/blob/main/docs/security-boundaries.md"
click node_operating "https://github.com/ai-architect-studio/agentic-architecture-field-guide/blob/main/docs/founder-operating-models.md"
click node_machine "https://github.com/ai-architect-studio/agentic-architecture-field-guide/blob/main/docs/local-install-audit.md"
click node_proof "https://github.com/ai-architect-studio/agentic-architecture-field-guide/blob/main/docs/architecture-proof-kit.md"
click node_templates "https://github.com/ai-architect-studio/agentic-architecture-field-guide/blob/main/packs/client-delivery/README.md"
click node_adaptation "https://github.com/ai-architect-studio/agentic-architecture-field-guide/blob/main/docs/labs/client-delivery-lab.md"
click node_workbench "https://github.com/ai-architect-studio/agentic-architecture-field-guide/blob/main/workbench/index.html"
click node_decision_report "https://github.com/ai-architect-studio/agentic-architecture-field-guide/blob/main/scripts/architecture-review.mjs"
click node_evidence_check "https://github.com/ai-architect-studio/agentic-architecture-field-guide/blob/main/scripts/release-evidence.mjs"
click node_support_agent "https://github.com/ai-architect-studio/agentic-architecture-field-guide/blob/main/examples/support-agent-reference/agent.mjs"
click node_support_rag "https://github.com/ai-architect-studio/agentic-architecture-field-guide/blob/main/examples/support-rag/README.md"
click node_consultant_brief "https://github.com/ai-architect-studio/agentic-architecture-field-guide/blob/main/examples/consultant-brief/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_start,node_runtime,node_patterns,node_trust,node_operating,node_machine toneBlue
class node_proof,node_templates,node_adaptation,node_workbench toneAmber
class node_decision_report,node_evidence_check toneMint
class node_support_agent,node_support_rag,node_consultant_brief toneRose
class node_reader toneIndigo
```

## Components

### Architecture Guide

- [Start guide](https://github.com/ai-architect-studio/agentic-architecture-field-guide/blob/main/START-HERE.md): `START-HERE.md`
- [Runtime choices](https://github.com/ai-architect-studio/agentic-architecture-field-guide/blob/main/docs/runtime-decision-matrix.md): `docs/runtime-decision-matrix.md`
- [Reference patterns](https://github.com/ai-architect-studio/agentic-architecture-field-guide/blob/main/docs/reference-architectures.md): `docs/reference-architectures.md`
- [Trust boundaries](https://github.com/ai-architect-studio/agentic-architecture-field-guide/blob/main/docs/security-boundaries.md): `docs/security-boundaries.md`
- [Operating models](https://github.com/ai-architect-studio/agentic-architecture-field-guide/blob/main/docs/founder-operating-models.md): `docs/founder-operating-models.md`
- [Local audit](https://github.com/ai-architect-studio/agentic-architecture-field-guide/blob/main/docs/local-install-audit.md): `docs/local-install-audit.md`

### Client Delivery

- [Architecture proof](https://github.com/ai-architect-studio/agentic-architecture-field-guide/blob/main/docs/architecture-proof-kit.md): `docs/architecture-proof-kit.md`
- [Delivery templates](https://github.com/ai-architect-studio/agentic-architecture-field-guide/blob/main/packs/client-delivery/README.md): `packs/client-delivery/README.md`
- [Adaptation lab](https://github.com/ai-architect-studio/agentic-architecture-field-guide/blob/main/docs/labs/client-delivery-lab.md): `docs/labs/client-delivery-lab.md`
- [Delivery workbench](https://github.com/ai-architect-studio/agentic-architecture-field-guide/blob/main/workbench/index.html): `workbench/index.html`

### Offline Tools

- [Decision report](https://github.com/ai-architect-studio/agentic-architecture-field-guide/blob/main/scripts/architecture-review.mjs): `scripts/architecture-review.mjs`
- [Evidence checker](https://github.com/ai-architect-studio/agentic-architecture-field-guide/blob/main/scripts/release-evidence.mjs): `scripts/release-evidence.mjs`

### Runnable Examples

- [Support agent](https://github.com/ai-architect-studio/agentic-architecture-field-guide/blob/main/examples/support-agent-reference/agent.mjs): `examples/support-agent-reference/agent.mjs`
- [Support RAG](https://github.com/ai-architect-studio/agentic-architecture-field-guide/blob/main/examples/support-rag/README.md): `examples/support-rag/README.md`
- [Consultant brief](https://github.com/ai-architect-studio/agentic-architecture-field-guide/blob/main/examples/consultant-brief/README.md): `examples/consultant-brief/README.md`

### Other components

- **Architect / operator**

## Connections

- Architect / operator → Start guide: begins with (evidence: `README.md`)
- Start guide → Delivery workbench: opens workbench (evidence: `README.md`)
- Start guide → Support agent: runs reference (evidence: `README.md`)
- Start guide → Delivery templates: uses templates (evidence: `README.md`)
- Start guide → Adaptation lab: follows lab (evidence: `README.md`)
- Architect / operator → Runtime choices: selects runtime (evidence: `README.md`)
- Architect / operator → Reference patterns: reviews patterns (evidence: `README.md`)
- Architect / operator → Trust boundaries: reviews boundaries (evidence: `README.md`)
- Architect / operator → Operating models: designs workflow (evidence: `README.md`)
- Architect / operator → Local audit: audits machine (evidence: `README.md`)
- Architect / operator → Architecture proof: documents rollout (evidence: `README.md`)
- Architect / operator → Decision report: reviews decision (evidence: `README.md`)
- Architect / operator → Evidence checker: checks evidence (evidence: `README.md`)
- Architect / operator → Support RAG: reviews handover (evidence: `README.md`)
- Architect / operator → Consultant brief: studies example (evidence: `README.md`)
