mirror of
https://github.com/razzant/ouroboros.git
synced 2026-10-03 04:07:04 +00:00
Persist an optional working folder in existing profile state and expose it through the owner tool and Skills card. Carry the admitted folder through turns, promotion and follow-ups while retaining canonical shared memory and preserving legacy profiles without a folder. Co-authored-by: Ouroboros <311266734+ouroboros-agent@users.noreply.github.com>
1.7 KiB
1.7 KiB
Ouroboros v7.0.0 — Architecture & Reference
This is the present-tense operational map of Ouroboros (BIBLE P6), in three layers: structure (what exists and where), operation (files, env keys, state paths, endpoints, flows), and rationale; it is NOT a changelog, and version history lives in README.md, git tags, and the commit log. Every important WHY stays in this book at least briefly, while mechanism detail lives in the module docstring the map points to by name, and rationale must be self-contained — future maintainers should not need old commits to understand why a guard, review gate, or lifecycle exists. The chapters below are the book: each owns one section of the map, and a change replaces the description of the node it touched.
Chapters
- 1. High-Level Architecture
- 2. Startup / Onboarding Flow
- 3. Web UI Pages & Buttons
- 4. Server API Endpoints
- 5. Supervisor Loop
- 6. Agent Core
- 7. Configuration (ouroboros/config.py)
- 8. Git Branching, CI, and Build
- 9. Shutdown & Process Cleanup
- 10. Key Invariants
- 11. Frozen Contracts v1 (
ouroboros/contracts/) - 12. Host Service, Companion Processes, and Chat IDs
- 13. External Skills Layer