This folder expands topics that would overcrowd the root README.md.
| Document | Description |
|---|---|
| COMMANDS.md | Slash-command reference and routing quirks |
| ARCHITECTURE.md | Orchestrator layout and import graph |
| BOOT_AND_SECURITY.md | Startup and authentication |
| CONFIGURATION.md | .env and kun.py |
| MEMORY_AND_RAG.md | PostgreSQL and Chroma behavior |
| VOICE.md | Voice modes and audio APIs |
| MODULES.md | Python module responsibilities |
| PROMPTS_AND_SOULSIG.md | System prompt and Soul Signature |
| TROUBLESHOOTING.md | Common failures |
| AI_NATIVE_GUIDE.md | Guide for AI agents contributing via fork and PR |
The repository root README.md is the primary entry for GitHub and local clones. Human and agent contributors should also read CONTRIBUTING.md.