Civilization Codex
Principles for Building a Wiser, Healthier, Cooperative Type-I Civilization
What this is
Humanity has accumulated thousands of years of moral, philosophical, spiritual, political, scientific, and social knowledge — but that knowledge remains fragmented across religions, philosophies, cultures, sciences, and institutions that rarely speak to one another directly.
Civilization Codex is an attempt to extract the most useful principles from those traditions, compare them against each other, test them against modern evidence, identify their failure modes, and turn the survivors into a practical framework for improving human wellbeing, collective intelligence, institutional quality, ecological sustainability, technological development, and civilization-scale cooperation.
This is not an attempt to found a new religion, prove any single tradition correct, or erase cultural difference. It is an attempt to ask, in good faith and across traditions: what have we actually learned, and can it be assembled into something usable?
The book's method, in one line:
> Tradition proposes. Reason examines. Evidence tests. Human dignity > constrains. Outcomes inform. Wisdom evolves.
See 00_frontmatter/01_introduction.md for the full statement of the project, and 00_frontmatter/02_how_to_read_this_book.md for how the chapters fit together.
Project rules
All working rules — the chapter template, the codex-principle template, the intellectual guardrails (never "religion says X therefore true," never "science says X therefore right"), and the tradition-classification scheme (prescriptive / descriptive / cautionary / symbolic / historical / universalizable) — live in CLAUDE.md so they stay consistent across every writing session.
Structure
Each chapter is its own Markdown file, grouped into numbered parts:
| Part | Theme |
|---|---|
00_frontmatter/ | Preface, introduction, how to read this book |
01_human_problem/ | Why civilization-building is hard: tribalism, status, violence, escalation |
02_ancient_wisdom/ | Survey of traditions — what each one actually claims |
03_science_of_flourishing/ | Modern evidence on wellbeing, cognition, trust, health |
04_civilizational_intelligence/ | The book's central framework: societies as error-correcting systems |
05_power_and_governance/ | Constraining and distributing power |
06_economics/ | What an economy is for, and for whom |
07_justice/ | Punishment, restoration, reconciliation |
08_education/ | Teaching people how to think |
09_ecology/ | The biosphere as infrastructure |
10_technology/ | Technology as force multiplier — for good or ill |
11_type_one_transition/ | An expanded, socially-aware Kardashev scale |
12_the_codex/ | The condensed principles, in strong standardized form |
13_institutional_design/ | Translating principles into institutions |
14_simulations/ | Stress-testing the framework against failure modes |
15_implementation/ | From philosophy to policy, city to planet |
16_conclusion/ | The choice before us |
appendices/ | Consolidated principles, metrics, sources, counterarguments, glossary |
Most files currently contain a title and a status stub (outline pending — not yet drafted) marking where they sit in the template. Frontmatter is drafted. Everything else is written incrementally, chapter by chapter.
Reading it
- Live: codex.pleniawellness.com —
served from the Plenia production EC2 instance, on its own nginx server blocks and its own Let's Encrypt certificate, isolated from the main marketplace app (see practice-suite/marketplace/nginx/nginx.conf). Update it after editing chapters with ./tools/deploy_prod.sh — this only rsyncs _site/ to the server, it never touches the marketplace's own git deploy pipeline.
- Local network:
./tools/serve.sh [port]rebuilds and serves the site
on this machine's LAN IP, default port 8080.
tools/build_site.pyis the (dependency-free) static site generator
behind both.
Status
Project scaffolded 2026-08-28. Frontmatter and Part I (01_human_problem/) drafted, plus two sample Codex principles (Mercy, Truth). All other chapters are stubs awaiting content — see each file's status line.