# arvedo/ai_readme architecture

> Architecture diagram of the GitHub repository arvedo/ai_readme, 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/arvedo/ai_readme
- Repository: https://github.com/arvedo/ai_readme

## Overview

This repository is a collection of contributor and maintainer guidance, not a runtime application. The user-facing flow is to choose a policy set and follow its contribution guidance; the documented outcome is an appropriately bounded AI-assisted contribution, with human accountability requirements varying by set. The README describes the sets but no source excerpts were provided, so relationships are limited to those documented there.

Main entry points: [`human_accountability_major`](https://github.com/arvedo/ai_readme/tree/main/human_accountability_major) (Major assistance), [`human_accountability_minor`](https://github.com/arvedo/ai_readme/tree/main/human_accountability_minor) (Minor assistance), [`strict_no`](https://github.com/arvedo/ai_readme/tree/main/strict_no) (Strict no-generation), [`live_die_ralphete`](https://github.com/arvedo/ai_readme/tree/main/live_die_ralphete) (Ralph-loop guidance)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_accountability["Accountability policies"]
  node_major["Major assistance"]
  node_minor["Minor assistance"]
  node_strict["Strict no-generation"]
end

subgraph group_agent_workflows["Agent workflow"]
  node_ralphete["Ralph-loop guidance"]
end

node_contributor(("Contributor or maintainer"))
node_contribution["Reviewed contribution"]

node_contributor -->|"chooses guidance"| node_major
node_contributor -->|"chooses guidance"| node_minor
node_contributor -->|"chooses guidance"| node_strict
node_contributor -->|"chooses guidance"| node_ralphete
node_major -->|"disclose and review"| node_contribution
node_minor -->|"human-led review"| node_contribution
node_strict -->|"avoid generation"| node_contribution
node_ralphete -->|"supports agent loops"| node_contribution

click node_major "https://github.com/arvedo/ai_readme/tree/main/human_accountability_major"
click node_minor "https://github.com/arvedo/ai_readme/tree/main/human_accountability_minor"
click node_strict "https://github.com/arvedo/ai_readme/tree/main/strict_no"
click node_ralphete "https://github.com/arvedo/ai_readme/tree/main/live_die_ralphete"

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_major,node_minor,node_strict,node_contribution toneBlue
class node_ralphete toneAmber
class node_contributor toneIndigo
```

## Components

### Accountability policies

- [Major assistance](https://github.com/arvedo/ai_readme/tree/main/human_accountability_major): `human_accountability_major`
- [Minor assistance](https://github.com/arvedo/ai_readme/tree/main/human_accountability_minor): `human_accountability_minor`
- [Strict no-generation](https://github.com/arvedo/ai_readme/tree/main/strict_no): `strict_no`

### Agent workflow

- [Ralph-loop guidance](https://github.com/arvedo/ai_readme/tree/main/live_die_ralphete): `live_die_ralphete`

### Other components

- **Contributor or maintainer**
- **Reviewed contribution**

## Connections

- Contributor or maintainer → Major assistance: chooses guidance (evidence: `README.md`)
- Contributor or maintainer → Minor assistance: chooses guidance (evidence: `README.md`)
- Contributor or maintainer → Strict no-generation: chooses guidance (evidence: `README.md`)
- Contributor or maintainer → Ralph-loop guidance: chooses guidance (evidence: `README.md`)
- Major assistance → Reviewed contribution: disclose and review (evidence: `README.md`)
- Minor assistance → Reviewed contribution: human-led review (evidence: `README.md`)
- Strict no-generation → Reviewed contribution: avoid generation (evidence: `README.md`)
- Ralph-loop guidance → Reviewed contribution: supports agent loops (evidence: `README.md`)
