Company Architecture
Scope: High-level view of how SuperPortia is organized — ships, agents, and systems
For detailed technical architecture diagrams, see Architecture (Resources).
Overview
SuperPortia operates as a distributed system across physical machines (ships) connected through a shared cloud brain:
Three pillars
| Pillar | What | Where |
|---|---|---|
| Universal Brain (UB) | Shared knowledge base | Cloud UB (Cloudflare D1) |
| Work Order System | Task management | Cloud UB API |
| Agent Messaging | Inter-agent communication | Cloud UB mailbox |
Key architectural decisions
| Decision | Choice | Why |
|---|---|---|
| Single vs distributed UB | Single Cloud UB | Eliminates knowledge fragmentation |
| Agent framework | Dual lines (Claude + LangGraph) | Mutual disaster recovery |
| Task system | WO with state machine | Audit trail, RBAC, accountability |
| Config management | CLAUDE.md + Rules + Hooks | Progressive disclosure, version-controlled |
| Deployment | Cloudflare Workers + Pages | Global edge, cost-effective |
Related pages
| Page | Relationship |
|---|---|
| Architecture (Resources) | Detailed technical diagrams |
| About Wishia | Company background |
| Fleet deployment | Ship-specific details |