cocapn-design

Design rationale and architectural decisions for the Cocapn Fleet refactor — why we chose what we chose.

What This Gives You

• Language choice analysis — why Python over Go/Rust/TS with hard constraints
• Architecture rationale — stripping the cathedral, keeping the organ
• Refactor blueprint — single-process, single-port fleet architecture
• Operational principles — maximum capability in minimum lines of code

Quick Start

git clone https://github.com/SuperInstance/cocapn-design.git
# Read the design document
cat DESIGN-RATIONALE.md

How It Fits

The architectural decision record for the Cocapn Fleet. Part of the SuperInstance ecosystem.

Related repos:

• cocapn-core — core fleet library
• cocapn-architecture — architecture docs
• cocapn-runtime — fleet runtime

License

Apache 2.0