OmoiOS

# OmoiOS Documentation

This is the root documentation directory for OmoiOS — a spec-driven, multi-agent orchestration system that turns feature ideas into PRs using parallel agent swarms.

## Documentation Structure

| Directory | Purpose | Key Files |
|-----------|---------|-----------|
| `architecture/` | System architecture deep-dives | 01-planning-system.md through 16-service-catalog.md |
| `design/` | Design documents by domain | sandbox-agents/, workflows/, auth/, frontend/, etc. |
| `figma_prompts/` | Figma Make prompts for UI | 11 sequential prompts for building the complete UI |
| `implementation/` | Implementation logs and guides | services/, tracking/ |
| `page_flows/` | Page-by-page UI flow docs | 24 documented flows |
| `proposals/` | OmoiOS Improvement Proposals (OIPs) | OIP-0001 through OIP-0007, TEMPLATE.md |
| `requirements/` | Requirements by system | agents/, monitoring/, billing/ |
| `research/` | Research reports and findings | Various technology evaluations |
| `user_journey/` | End-to-end user journey docs | 16 files from onboarding to billing |
| `assets/` | Static assets (images, GIFs, banners) | demo GIFs, banner.svg, social-preview.png |

## Quick Navigation

**For AI Coding Agents:**
- Start with [../AGENTS.md](../AGENTS.md) for codebase orientation
- See [../ARCHITECTURE.md](../ARCHITECTURE.md) for system design
- Check [../UI.md](../UI.md) for frontend routes and components

**For New Contributors:**
- Read [../CONTRIBUTING.md](../CONTRIBUTING.md) for setup and conventions
- Review [../CLAUDE.md](../CLAUDE.md) for monorepo structure

**Key Documents:**
- product_vision.md — Full product vision
- app_overview.md — Core features and user flows
- page_architecture.md — All frontend pages detailed
- design_system.md — Complete design system

<claude-mem-context>
# Recent Activity

<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->

### Mar 3, 2026

| ID | Time | T | Title | Read |
|----|------|---|-------|------|
| #6518 | 11:28 AM | ✅ | Committed dev stack fixes and Next.js memory optimizations | ~538 |
| #6515 | 11:26 AM | ✅ | Added pragma allowlist secret comment to DATABASE_URL in installation.md | ~58 |
| #6489 | 9:54 AM | ✅ | Expanded `just` installation guide in docs/installation.md with comprehensive platform-specific package manager tables | ~602 |
| #6488 | " | 🟣 | Created AI-executable installation runbook at docs/installation.md | ~511 |
| #6484 | 9:50 AM | ✅ | Created comprehensive AI-executable installation runbook | ~769 |
</claude-mem-context>