# rai220/agents_crew architecture

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

- Interactive diagram: https://gitdiagram.com/rai220/agents_crew
- Repository: https://github.com/rai220/agents_crew

## Overview

agents_crew is a file-based “meta-harness” for a team of specialized AI coworkers: each coworker is a directory of role instructions and persistent Markdown knowledge, launched by an external console harness. The main workflow is to launch a coworker in its directory, load its instructions and memory index, consult linked project or access notes while working, and record useful learning for later runs. Coworkers can consult one another by launching a neighbor’s harness. Relationships below are based on README documentation; no runtime source excerpts were provided.

Main entry points: [`crew_lora/memory/MEMORY.md`](https://github.com/rai220/agents_crew/blob/main/crew_lora/memory/MEMORY.md) (Lora memory index), [`crew_alfred/memory/MEMORY.md`](https://github.com/rai220/agents_crew/blob/main/crew_alfred/memory/MEMORY.md) (Alfred memory index), [`CREW.md`](https://github.com/rai220/agents_crew/blob/main/CREW.md) (Crew roster), [`crew_template/README.md`](https://github.com/rai220/agents_crew/blob/main/crew_template/README.md) (Coworker template)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_governance["Team governance"]
  node_team_rules["Team rules<br/>[AGENTS.md]"]
  node_crew_roster["Crew roster<br/>[CREW.md]"]
end

subgraph group_profiles["Coworker profiles"]
  node_template["Coworker template<br/>[README.md]"]
  node_lora_role["Lora role<br/>[AGENTS.md]"]
  node_steve_role["Steve role<br/>[AGENTS.md]"]
  node_alfred_role["Alfred role<br/>[AGENTS.md]"]
end

subgraph group_knowledge["Persistent knowledge"]
  node_lora_index["Lora memory index<br/>[MEMORY.md]"]
  node_steve_index["Steve memory index<br/>[MEMORY.md]"]
  node_alfred_index["Alfred memory index<br/>[MEMORY.md]"]
  node_project_notes["Project notes"]
  node_access_notes["Access notes"]
  node_lessons["Lessons and stack<br/>[lessons.md]"]
  node_journal["Work journal"]
end

subgraph group_runtime["Harness runtime"]
  node_harness["Console harness"]
  node_neighbor_harness["Neighbor harness"]
end

node_operator(("Human operator"))

node_operator -->|"launches"| node_harness
node_harness -->|"loads instructions"| node_lora_role
node_harness -->|"reads at start"| node_lora_index
node_lora_index -->|"links to"| node_project_notes
node_harness -->|"records learning"| node_lessons
node_harness -->|"records chronology"| node_journal
node_harness -->|"launches for advice"| node_neighbor_harness
node_operator -->|"checks assignments"| node_crew_roster
node_operator -->|"starts from"| node_template
node_harness -->|"loads instructions"| node_steve_role
node_harness -->|"loads instructions"| node_alfred_role
node_harness -->|"reads at start"| node_steve_index
node_harness -->|"reads at start"| node_alfred_index
node_alfred_index -->|"links to"| node_access_notes
node_neighbor_harness -->|"returns advice"| node_harness

click node_team_rules "https://github.com/rai220/agents_crew/blob/main/AGENTS.md"
click node_crew_roster "https://github.com/rai220/agents_crew/blob/main/CREW.md"
click node_template "https://github.com/rai220/agents_crew/blob/main/crew_template/README.md"
click node_lora_role "https://github.com/rai220/agents_crew/blob/main/crew_lora/AGENTS.md"
click node_steve_role "https://github.com/rai220/agents_crew/blob/main/crew_steve/AGENTS.md"
click node_alfred_role "https://github.com/rai220/agents_crew/blob/main/crew_alfred/AGENTS.md"
click node_lora_index "https://github.com/rai220/agents_crew/blob/main/crew_lora/memory/MEMORY.md"
click node_steve_index "https://github.com/rai220/agents_crew/blob/main/crew_steve/memory/MEMORY.md"
click node_alfred_index "https://github.com/rai220/agents_crew/blob/main/crew_alfred/memory/MEMORY.md"
click node_project_notes "https://github.com/rai220/agents_crew/tree/main/crew_lora/memory/projects"
click node_access_notes "https://github.com/rai220/agents_crew/tree/main/crew_alfred/memory/access"
click node_lessons "https://github.com/rai220/agents_crew/blob/main/crew_lora/memory/lessons.md"
click node_journal "https://github.com/rai220/agents_crew/tree/main/crew_lora/journal"

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_team_rules,node_crew_roster toneBlue
class node_template,node_lora_role,node_steve_role,node_alfred_role toneAmber
class node_lora_index,node_steve_index,node_alfred_index,node_project_notes,node_access_notes,node_lessons,node_journal toneMint
class node_harness,node_neighbor_harness toneRose
class node_operator toneIndigo
```

## Components

### Team governance

- [Team rules](https://github.com/rai220/agents_crew/blob/main/AGENTS.md): `AGENTS.md`
- [Crew roster](https://github.com/rai220/agents_crew/blob/main/CREW.md): `CREW.md`

### Coworker profiles

- [Coworker template](https://github.com/rai220/agents_crew/blob/main/crew_template/README.md): `crew_template/README.md`
- [Lora role](https://github.com/rai220/agents_crew/blob/main/crew_lora/AGENTS.md): `crew_lora/AGENTS.md`
- [Steve role](https://github.com/rai220/agents_crew/blob/main/crew_steve/AGENTS.md): `crew_steve/AGENTS.md`
- [Alfred role](https://github.com/rai220/agents_crew/blob/main/crew_alfred/AGENTS.md): `crew_alfred/AGENTS.md`

### Persistent knowledge

- [Lora memory index](https://github.com/rai220/agents_crew/blob/main/crew_lora/memory/MEMORY.md): `crew_lora/memory/MEMORY.md`
- [Steve memory index](https://github.com/rai220/agents_crew/blob/main/crew_steve/memory/MEMORY.md): `crew_steve/memory/MEMORY.md`
- [Alfred memory index](https://github.com/rai220/agents_crew/blob/main/crew_alfred/memory/MEMORY.md): `crew_alfred/memory/MEMORY.md`
- [Project notes](https://github.com/rai220/agents_crew/tree/main/crew_lora/memory/projects): `crew_lora/memory/projects`
- [Access notes](https://github.com/rai220/agents_crew/tree/main/crew_alfred/memory/access): `crew_alfred/memory/access`
- [Lessons and stack](https://github.com/rai220/agents_crew/blob/main/crew_lora/memory/lessons.md): `crew_lora/memory/lessons.md`
- [Work journal](https://github.com/rai220/agents_crew/tree/main/crew_lora/journal): `crew_lora/journal`

### Harness runtime

- **Console harness**
- **Neighbor harness**

### Other components

- **Human operator**

## Connections

- Human operator → Console harness: launches (evidence: `README.md`)
- Console harness → Lora role: loads instructions (evidence: `README.md`)
- Console harness → Lora memory index: reads at start (evidence: `README.md`)
- Lora memory index → Project notes: links to (evidence: `README.md`)
- Console harness → Lessons and stack: records learning (evidence: `README.md`)
- Console harness → Work journal: records chronology (evidence: `README.md`)
- Console harness → Neighbor harness: launches for advice (evidence: `README.md`)
- Human operator → Crew roster: checks assignments (evidence: `README.md`)
- Human operator → Coworker template: starts from (evidence: `README.md`)
- Console harness → Steve role: loads instructions (evidence: `README.md`)
- Console harness → Alfred role: loads instructions (evidence: `README.md`)
- Console harness → Steve memory index: reads at start (evidence: `README.md`)
- Console harness → Alfred memory index: reads at start (evidence: `README.md`)
- Alfred memory index → Access notes: links to (evidence: `README.md`)
- Neighbor harness → Console harness: returns advice (evidence: `README.md`)
