Dev Handbook (Start Here)

This section is the canonical onboarding path for contributors working on PyCauset.

What this is

• A high-signal, low-ambiguity set of docs describing how the project is structured, how to contribute safely, and what invariants must not be violated.
• Written to support long-running work across many sessions and many contributors.

Read order

1. dev/Restructure Plan
2. dev/Codebase Structure
3. dev/Python Internals
4. guides/Storage and Memory
5. dev/Build System
6. dev/Bindings & Dispatch
7. dev/Warnings & Exceptions
8. dev/Testing & Benchmarks
9. dev/Repository Hygiene
10. internals/Streaming Manager

Related

• project/Philosophy (core mantras)
• project/protocols/ (definition-of-done for docs/changes)
• internals/index (architecture deep dives)