# tiziasan/ciao-code-in-architecture-out architecture

> Architecture diagram of the GitHub repository tiziasan/ciao-code-in-architecture-out, 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/tiziasan/ciao-code-in-architecture-out
- Repository: https://github.com/tiziasan/ciao-code-in-architecture-out

## Overview

CIAO is a command-line repository-to-documentation generator. A user supplies a local repository or Git URL; CIAO invokes Repomix to flatten its code, loads prompt templates and guidelines, generates template sections concurrently through the OpenAI API, then writes the assembled Markdown. The graph separates input preparation, prompt construction, and section generation while keeping their shared implementation path explicit. The excerpt shows these runtime calls; the README documents the overall workflow. The README and sampled source differ on the output filename, so the graph labels the output generically.

Main entry points: [`CIAO-system/main.py`](https://github.com/tiziasan/ciao-code-in-architecture-out/blob/main/CIAO-system/main.py) (Async entry point), [`CIAO-system/prompt.json`](https://github.com/tiziasan/ciao-code-in-architecture-out/blob/main/CIAO-system/prompt.json) (Prompt templates), [`CIAO-system/repomix.config.json`](https://github.com/tiziasan/ciao-code-in-architecture-out/blob/main/CIAO-system/repomix.config.json) (Repomix settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI orchestration"]
  node_entry["Async entry point<br/>[main.py]"]
  node_arguments["Argument parsing<br/>[main.py]"]
  node_section_tasks["Section task fan-out<br/>[main.py]"]
  node_assembly["Markdown assembly<br/>[main.py]"]
end

subgraph group_input["Repository preparation"]
  node_flatten["Repository flattener<br/>[main.py]"]
  node_code["Flattened code"]
end

subgraph group_generation["Documentation generation"]
  node_schema["Memory schema<br/>[main.py]"]
  node_section_walk["Template traversal<br/>[main.py]"]
  node_section_prompt["Section prompt builder<br/>[main.py]"]
  node_token_count["Token limit check<br/>[main.py]"]
  node_semaphore["Concurrency limiter<br/>[main.py]"]
  node_retry["API retry handler<br/>[main.py]"]
  node_sections["Generated sections"]
end

subgraph group_configuration["Prompt configuration"]
  node_config["Repomix settings"]
  node_memory["Prompt templates<br/>[prompt.json]"]
end

node_user(("CLI user"))
node_repo["Target repository"]
node_repomix["Repomix CLI"]
node_openai["OpenAI API"]
node_output["Markdown document"]

node_user -->|"runs"| node_entry
node_entry -->|"parses options"| node_arguments
node_arguments -->|"accepts path or URL"| node_repo
node_entry -->|"flattens repository"| node_flatten
node_flatten -->|"invokes"| node_repomix
node_flatten -->|"passes settings"| node_config
node_flatten -->|"processes"| node_repo
node_flatten -->|"reads flattened file"| node_code
node_entry -->|"loads templates"| node_memory
node_entry -->|"validates memory"| node_schema
node_entry -->|"traverses template"| node_section_walk
node_section_walk -->|"creates tasks"| node_section_tasks
node_entry -->|"launches concurrently"| node_section_tasks
node_section_tasks -->|"generates section"| node_section_prompt
node_section_prompt -->|"includes source text"| node_code
node_section_prompt -->|"uses prompt guidance"| node_memory
node_section_prompt -->|"checks prompt size"| node_token_count
node_section_prompt -->|"limits API calls"| node_semaphore
node_semaphore -->|"dispatches request"| node_retry
node_retry -->|"calls with retries"| node_openai
node_retry -->|"returns section text"| node_sections
node_entry -->|"gathers sections"| node_assembly
node_assembly -->|"combines results"| node_sections
node_assembly -->|"writes Markdown"| node_output

click node_entry "https://github.com/tiziasan/ciao-code-in-architecture-out/blob/main/CIAO-system/main.py"
click node_arguments "https://github.com/tiziasan/ciao-code-in-architecture-out/blob/main/CIAO-system/main.py"
click node_flatten "https://github.com/tiziasan/ciao-code-in-architecture-out/blob/main/CIAO-system/main.py"
click node_config "https://github.com/tiziasan/ciao-code-in-architecture-out/blob/main/CIAO-system/repomix.config.json"
click node_memory "https://github.com/tiziasan/ciao-code-in-architecture-out/blob/main/CIAO-system/prompt.json"
click node_schema "https://github.com/tiziasan/ciao-code-in-architecture-out/blob/main/CIAO-system/main.py"
click node_section_walk "https://github.com/tiziasan/ciao-code-in-architecture-out/blob/main/CIAO-system/main.py"
click node_section_tasks "https://github.com/tiziasan/ciao-code-in-architecture-out/blob/main/CIAO-system/main.py"
click node_section_prompt "https://github.com/tiziasan/ciao-code-in-architecture-out/blob/main/CIAO-system/main.py"
click node_token_count "https://github.com/tiziasan/ciao-code-in-architecture-out/blob/main/CIAO-system/main.py"
click node_semaphore "https://github.com/tiziasan/ciao-code-in-architecture-out/blob/main/CIAO-system/main.py"
click node_retry "https://github.com/tiziasan/ciao-code-in-architecture-out/blob/main/CIAO-system/main.py"
click node_assembly "https://github.com/tiziasan/ciao-code-in-architecture-out/blob/main/CIAO-system/main.py"

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_entry,node_arguments,node_section_tasks,node_assembly,node_user toneBlue
class node_flatten,node_code toneAmber
class node_schema,node_section_walk,node_section_prompt,node_token_count,node_semaphore,node_retry,node_sections,node_openai toneMint
class node_config,node_memory toneRose
class node_repo,node_repomix,node_output toneIndigo
```

## Components

### CLI orchestration

- [Async entry point](https://github.com/tiziasan/ciao-code-in-architecture-out/blob/main/CIAO-system/main.py): `CIAO-system/main.py`
- [Argument parsing](https://github.com/tiziasan/ciao-code-in-architecture-out/blob/main/CIAO-system/main.py): `CIAO-system/main.py`
- [Section task fan-out](https://github.com/tiziasan/ciao-code-in-architecture-out/blob/main/CIAO-system/main.py): `CIAO-system/main.py`
- [Markdown assembly](https://github.com/tiziasan/ciao-code-in-architecture-out/blob/main/CIAO-system/main.py): `CIAO-system/main.py`

### Repository preparation

- [Repository flattener](https://github.com/tiziasan/ciao-code-in-architecture-out/blob/main/CIAO-system/main.py): `CIAO-system/main.py`
- **Flattened code**

### Documentation generation

- [Memory schema](https://github.com/tiziasan/ciao-code-in-architecture-out/blob/main/CIAO-system/main.py): `CIAO-system/main.py`
- [Template traversal](https://github.com/tiziasan/ciao-code-in-architecture-out/blob/main/CIAO-system/main.py): `CIAO-system/main.py`
- [Section prompt builder](https://github.com/tiziasan/ciao-code-in-architecture-out/blob/main/CIAO-system/main.py): `CIAO-system/main.py`
- [Token limit check](https://github.com/tiziasan/ciao-code-in-architecture-out/blob/main/CIAO-system/main.py): `CIAO-system/main.py`
- [Concurrency limiter](https://github.com/tiziasan/ciao-code-in-architecture-out/blob/main/CIAO-system/main.py): `CIAO-system/main.py`
- [API retry handler](https://github.com/tiziasan/ciao-code-in-architecture-out/blob/main/CIAO-system/main.py): `CIAO-system/main.py`
- **Generated sections**

### Prompt configuration

- [Repomix settings](https://github.com/tiziasan/ciao-code-in-architecture-out/blob/main/CIAO-system/repomix.config.json): `CIAO-system/repomix.config.json`
- [Prompt templates](https://github.com/tiziasan/ciao-code-in-architecture-out/blob/main/CIAO-system/prompt.json): `CIAO-system/prompt.json`

### Other components

- **CLI user**
- **Target repository**
- **Repomix CLI**
- **OpenAI API**
- **Markdown document**

## Connections

- CLI user → Async entry point: runs (evidence: `README.md`)
- Async entry point → Argument parsing: parses options (evidence: `CIAO-system/main.py`)
- Argument parsing → Target repository: accepts path or URL (evidence: `README.md`)
- Async entry point → Repository flattener: flattens repository (evidence: `CIAO-system/main.py`)
- Repository flattener → Repomix CLI: invokes (evidence: `CIAO-system/main.py`)
- Repository flattener → Repomix settings: passes settings (evidence: `CIAO-system/main.py`)
- Repository flattener → Target repository: processes (evidence: `CIAO-system/main.py`)
- Repository flattener → Flattened code: reads flattened file (evidence: `CIAO-system/main.py`)
- Async entry point → Prompt templates: loads templates (evidence: `CIAO-system/main.py`)
- Async entry point → Memory schema: validates memory (evidence: `CIAO-system/main.py`)
- Async entry point → Template traversal: traverses template (evidence: `CIAO-system/main.py`)
- Template traversal → Section task fan-out: creates tasks (evidence: `CIAO-system/main.py`)
- Async entry point → Section task fan-out: launches concurrently (evidence: `CIAO-system/main.py`)
- Section task fan-out → Section prompt builder: generates section (evidence: `CIAO-system/main.py`)
- Section prompt builder → Flattened code: includes source text (evidence: `CIAO-system/main.py`)
- Section prompt builder → Prompt templates: uses prompt guidance (evidence: `CIAO-system/main.py`)
- Section prompt builder → Token limit check: checks prompt size (evidence: `CIAO-system/main.py`)
- Section prompt builder → Concurrency limiter: limits API calls (evidence: `CIAO-system/main.py`)
- Concurrency limiter → API retry handler: dispatches request (evidence: `CIAO-system/main.py`)
- API retry handler → OpenAI API: calls with retries (evidence: `CIAO-system/main.py`)
- API retry handler → Generated sections: returns section text (evidence: `CIAO-system/main.py`)
- Async entry point → Markdown assembly: gathers sections (evidence: `CIAO-system/main.py`)
- Markdown assembly → Generated sections: combines results (evidence: `CIAO-system/main.py`)
- Markdown assembly → Markdown document: writes Markdown (evidence: `CIAO-system/main.py`)
