# automata/aicodeguide architecture

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

- Interactive diagram: https://gitdiagram.com/automata/aicodeguide
- Repository: https://github.com/automata/aicodeguide

## Overview

This repository is a human-authored guide to AI-assisted coding, not a software runtime. Its reader workflow is to understand the coding modes, choose how to use AI, then follow the roadmap to tools suited to their experience. The README also documents practices and curated resources. The tree contains only README.md, so all content areas point to that file; no implementation-level relationships can be established.

Main entry points: [`README.md`](https://github.com/automata/aicodeguide/blob/main/README.md) (AI Code Guide)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orientation["Concepts and orientation"]
  node_guide["AI Code Guide<br/>[README.md]"]
  node_coding_modes["Coding modes<br/>[README.md]"]
end

subgraph group_practice["Coding practices"]
  node_copilot_pilot["Copilot or pilot<br/>[README.md]"]
  node_coding_practices["Coding practices<br/>[README.md]"]
end

subgraph group_roadmap["Tools and roadmap"]
  node_starting_points["Starting points<br/>[README.md]"]
  node_coding_tools["Coding tools<br/>[README.md]"]
  node_resources["Further resources<br/>[README.md]"]
end

node_reader(("Reader"))
node_ai_models{{"AI models"}}
node_coding_assistants{{"Coding assistants"}}

node_reader -->|"reads"| node_guide
node_guide -->|"explains"| node_coding_modes
node_guide -->|"describes"| node_copilot_pilot
node_guide -->|"presents"| node_coding_practices
node_guide -->|"recommends"| node_starting_points
node_guide -->|"surveys"| node_coding_tools
node_guide -->|"curates"| node_resources
node_coding_modes -->|"discusses"| node_ai_models
node_coding_modes -->|"describes use of"| node_coding_assistants
node_starting_points -->|"recommends"| node_coding_assistants

click node_guide "https://github.com/automata/aicodeguide/blob/main/README.md"
click node_coding_modes "https://github.com/automata/aicodeguide/blob/main/README.md"
click node_copilot_pilot "https://github.com/automata/aicodeguide/blob/main/README.md"
click node_coding_practices "https://github.com/automata/aicodeguide/blob/main/README.md"
click node_starting_points "https://github.com/automata/aicodeguide/blob/main/README.md"
click node_coding_tools "https://github.com/automata/aicodeguide/blob/main/README.md"
click node_resources "https://github.com/automata/aicodeguide/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_guide,node_coding_modes toneBlue
class node_copilot_pilot,node_coding_practices toneAmber
class node_starting_points,node_coding_tools,node_resources toneMint
class node_reader,node_ai_models,node_coding_assistants toneIndigo
```

## Components

### Concepts and orientation

- [AI Code Guide](https://github.com/automata/aicodeguide/blob/main/README.md): `README.md`
- [Coding modes](https://github.com/automata/aicodeguide/blob/main/README.md): `README.md`

### Coding practices

- [Copilot or pilot](https://github.com/automata/aicodeguide/blob/main/README.md): `README.md`
- [Coding practices](https://github.com/automata/aicodeguide/blob/main/README.md): `README.md`

### Tools and roadmap

- [Starting points](https://github.com/automata/aicodeguide/blob/main/README.md): `README.md`
- [Coding tools](https://github.com/automata/aicodeguide/blob/main/README.md): `README.md`
- [Further resources](https://github.com/automata/aicodeguide/blob/main/README.md): `README.md`

### Other components

- **Reader**
- **AI models**
- **Coding assistants**

## Connections

- Reader → AI Code Guide: reads
- AI Code Guide → Coding modes: explains
- AI Code Guide → Copilot or pilot: describes
- AI Code Guide → Coding practices: presents
- AI Code Guide → Starting points: recommends
- AI Code Guide → Coding tools: surveys
- AI Code Guide → Further resources: curates
- Coding modes → AI models: discusses
- Coding modes → Coding assistants: describes use of
- Starting points → Coding assistants: recommends