# fuzaro/eeemiad architecture

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

- Interactive diagram: https://gitdiagram.com/fuzaro/eeemiad
- Repository: https://github.com/fuzaro/eeemiad

## Overview

EEEMIAD is a software-engineering methodology for AI-built systems, not a conventional application. Its principal workflow takes a project request through a Plan, ratified ADR, specification and evolutionary implementation arcs, with evidence-based verification and governance sweeps. The repository expresses that workflow through guidance, reusable templates, a project initializer, verifier skills and executable examples. The graph reflects README-documented relationships; unsampled subsystems are represented at their listed directory paths.

Main entry points: [`docs/pt/06-construcao-evolutiva.md`](https://github.com/fuzaro/eeemiad/blob/main/docs/pt/06-construcao-evolutiva.md) (Evolutionary arcs), [`docs/pt/03-hierarquia-da-verdade.md`](https://github.com/fuzaro/eeemiad/blob/main/docs/pt/03-hierarquia-da-verdade.md) (Truth hierarchy), [`templates/pt`](https://github.com/fuzaro/eeemiad/tree/main/templates/pt) (Governance templates), [`starter/eee_init.py`](https://github.com/fuzaro/eeemiad/blob/main/starter/eee_init.py) (Project initializer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_method["Methodology"]
  node_hierarchy["Truth hierarchy"]
  node_cycle["Cycle phases"]
  node_evolution["Evolutionary arcs"]
  node_principles["Principles and rules"]
end

subgraph group_artifacts["Project Artifacts"]
  node_templates["Governance templates"]
  node_plan["Project Plan"]
  node_adr["Architecture decision"]
  node_spec["System specification"]
  node_code["Implementation"]
  node_evidence["Verification evidence"]
end

subgraph group_automation["Automation"]
  node_initializer["Project initializer<br/>[eee_init.py]"]
  node_verifier["Adversarial verifier"]
  node_sweep["Governance sweep<br/>[sweep_codebase.py]"]
end

subgraph group_examples["Examples"]
  node_arc_example["Evolutionary arc demo"]
  node_reference["Reference implementation"]
  node_harness["Verification harness"]
end

node_engineer(("Project team"))

node_engineer -->|"starts project"| node_initializer
node_initializer -->|"copies templates"| node_templates
node_engineer -->|"defines request"| node_plan
node_plan -->|"informs decision"| node_adr
node_adr -->|"constrains design"| node_spec
node_spec -->|"guides implementation"| node_code
node_hierarchy -->|"sets precedence"| node_plan
node_cycle -->|"describes phases"| node_evolution
node_evolution -->|"builds in arcs"| node_code
node_principles -->|"defines evidence rules"| node_evidence
node_verifier -->|"checks against spec"| node_evidence
node_harness -->|"demonstrates verification"| node_evidence
node_sweep -->|"checks coverage"| node_spec
node_arc_example -->|"demonstrates arcs"| node_evolution
node_reference -->|"demonstrates workflow"| node_hierarchy
node_templates -->|"provides formats"| node_plan

click node_hierarchy "https://github.com/fuzaro/eeemiad/blob/main/docs/pt/03-hierarquia-da-verdade.md"
click node_cycle "https://github.com/fuzaro/eeemiad/blob/main/docs/pt/04-fases-do-ciclo.md"
click node_evolution "https://github.com/fuzaro/eeemiad/blob/main/docs/pt/06-construcao-evolutiva.md"
click node_principles "https://github.com/fuzaro/eeemiad/blob/main/docs/pt/05-regras-do-refinamento.md"
click node_templates "https://github.com/fuzaro/eeemiad/tree/main/templates/pt"
click node_initializer "https://github.com/fuzaro/eeemiad/blob/main/starter/eee_init.py"
click node_verifier "https://github.com/fuzaro/eeemiad/tree/main/skills/eee-adversarial-verifier"
click node_sweep "https://github.com/fuzaro/eeemiad/blob/main/skills/eee-governance-sweep/scripts/sweep_codebase.py"
click node_arc_example "https://github.com/fuzaro/eeemiad/tree/main/examples/evolutionary-arc"
click node_reference "https://github.com/fuzaro/eeemiad/tree/main/examples/reference-implementation"
click node_harness "https://github.com/fuzaro/eeemiad/tree/main/examples/verification-harness"

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_hierarchy,node_cycle,node_evolution,node_principles toneBlue
class node_templates,node_plan,node_adr,node_spec,node_code,node_evidence toneAmber
class node_initializer,node_verifier,node_sweep toneMint
class node_arc_example,node_reference,node_harness toneRose
class node_engineer toneIndigo
```

## Components

### Methodology

- [Truth hierarchy](https://github.com/fuzaro/eeemiad/blob/main/docs/pt/03-hierarquia-da-verdade.md): `docs/pt/03-hierarquia-da-verdade.md`
- [Cycle phases](https://github.com/fuzaro/eeemiad/blob/main/docs/pt/04-fases-do-ciclo.md): `docs/pt/04-fases-do-ciclo.md`
- [Evolutionary arcs](https://github.com/fuzaro/eeemiad/blob/main/docs/pt/06-construcao-evolutiva.md): `docs/pt/06-construcao-evolutiva.md`
- [Principles and rules](https://github.com/fuzaro/eeemiad/blob/main/docs/pt/05-regras-do-refinamento.md): `docs/pt/05-regras-do-refinamento.md`

### Project Artifacts

- [Governance templates](https://github.com/fuzaro/eeemiad/tree/main/templates/pt): `templates/pt`
- **Project Plan**
- **Architecture decision**
- **System specification**
- **Implementation**
- **Verification evidence**

### Automation

- [Project initializer](https://github.com/fuzaro/eeemiad/blob/main/starter/eee_init.py): `starter/eee_init.py`
- [Adversarial verifier](https://github.com/fuzaro/eeemiad/tree/main/skills/eee-adversarial-verifier): `skills/eee-adversarial-verifier`
- [Governance sweep](https://github.com/fuzaro/eeemiad/blob/main/skills/eee-governance-sweep/scripts/sweep_codebase.py): `skills/eee-governance-sweep/scripts/sweep_codebase.py`

### Examples

- [Evolutionary arc demo](https://github.com/fuzaro/eeemiad/tree/main/examples/evolutionary-arc): `examples/evolutionary-arc`
- [Reference implementation](https://github.com/fuzaro/eeemiad/tree/main/examples/reference-implementation): `examples/reference-implementation`
- [Verification harness](https://github.com/fuzaro/eeemiad/tree/main/examples/verification-harness): `examples/verification-harness`

### Other components

- **Project team**

## Connections

- Project team → Project initializer: starts project (evidence: `README.md`)
- Project initializer → Governance templates: copies templates (evidence: `starter/eee_init.py`)
- Project team → Project Plan: defines request (evidence: `README.md`)
- Project Plan → Architecture decision: informs decision (evidence: `README.md`)
- Architecture decision → System specification: constrains design (evidence: `README.md`)
- System specification → Implementation: guides implementation (evidence: `README.md`)
- Truth hierarchy → Project Plan: sets precedence (evidence: `README.md`)
- Cycle phases → Evolutionary arcs: describes phases (evidence: `README.md`)
- Evolutionary arcs → Implementation: builds in arcs (evidence: `README.md`)
- Principles and rules → Verification evidence: defines evidence rules (evidence: `README.md`)
- Adversarial verifier → Verification evidence: checks against spec (evidence: `README.md`)
- Verification harness → Verification evidence: demonstrates verification (evidence: `README.md`)
- Governance sweep → System specification: checks coverage (evidence: `README.md`)
- Evolutionary arc demo → Evolutionary arcs: demonstrates arcs (evidence: `README.md`)
- Reference implementation → Truth hierarchy: demonstrates workflow (evidence: `README.md`)
- Governance templates → Project Plan: provides formats (evidence: `README.md`)
