How tiziasan/ciao-code-in-architecture-out works
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: main.py Async entry point · prompt.json Prompt templates · repomix.config.json Repomix settings
Components 20
CLI orchestration
- Async entry point
CIAO-system/main.py - Argument parsing
CIAO-system/main.py - Section task fan-out
CIAO-system/main.py - Markdown assembly
CIAO-system/main.py
Repository preparation
- Repository flattener
CIAO-system/main.py - Flattened code
Documentation generation
- Memory schema
CIAO-system/main.py - Template traversal
CIAO-system/main.py - Section prompt builder
CIAO-system/main.py - Token limit check
CIAO-system/main.py - Concurrency limiter
CIAO-system/main.py - API retry handler
CIAO-system/main.py - Generated sections
Prompt configuration
- Repomix settings
CIAO-system/repomix.config.json - Prompt templates
CIAO-system/prompt.json
Other components
- CLI user
- Target repository
- Repomix CLI
- OpenAI API
- Markdown document
Connections 24
- CLI user → Async entry point: runs
README.md - Async entry point → Argument parsing: parses options
CIAO-system/main.py - Argument parsing → Target repository: accepts path or URL
README.md - Async entry point → Repository flattener: flattens repository
CIAO-system/main.py - Repository flattener → Repomix CLI: invokes
CIAO-system/main.py - Repository flattener → Repomix settings: passes settings
CIAO-system/main.py - Repository flattener → Target repository: processes
CIAO-system/main.py - Repository flattener → Flattened code: reads flattened file
CIAO-system/main.py - Async entry point → Prompt templates: loads templates
CIAO-system/main.py - Async entry point → Memory schema: validates memory
CIAO-system/main.py - Async entry point → Template traversal: traverses template
CIAO-system/main.py - Template traversal → Section task fan-out: creates tasks
CIAO-system/main.py - Async entry point → Section task fan-out: launches concurrently
CIAO-system/main.py - Section task fan-out → Section prompt builder: generates section
CIAO-system/main.py - Section prompt builder → Flattened code: includes source text
CIAO-system/main.py - Section prompt builder → Prompt templates: uses prompt guidance
CIAO-system/main.py - Section prompt builder → Token limit check: checks prompt size
CIAO-system/main.py - Section prompt builder → Concurrency limiter: limits API calls
CIAO-system/main.py - Concurrency limiter → API retry handler: dispatches request
CIAO-system/main.py - API retry handler → OpenAI API: calls with retries
CIAO-system/main.py - API retry handler → Generated sections: returns section text
CIAO-system/main.py - Async entry point → Markdown assembly: gathers sections
CIAO-system/main.py - Markdown assembly → Generated sections: combines results
CIAO-system/main.py - Markdown assembly → Markdown document: writes Markdown
CIAO-system/main.py