Book Structure

Repository Layout

society-in-silico/
├── manuscript/              # The book itself
│   ├── front-matter/        # Introduction, preface
│   ├── part-1-origins/      # History of microsimulation
│   ├── part-2-building/     # PolicyEngine journey
│   └── part-3-future/       # AI and what's next
├── research/                # Background research
│   ├── people/              # Key figures
│   ├── concepts/            # Technical concepts
│   ├── timeline/            # Chronology
│   └── references/          # Sources
├── assets/                  # Images, diagrams
└── build/                   # Compilation (Pandoc)

Book Outline

Part I: Origins

The intellectual history of microsimulation.

• Guy Orcutt's 1957 vision
• DYNASIM and early mainframe models
• IFS TAXBEN and institutional microsimulation
• NBER TAXSIM
• The closed-model era

Part II: Building

The open-source turn and PolicyEngine journey.

• OpenFisca and rules-as-code
• Tax-Calculator as gateway
• Founding PolicyEngine with Nikhil
• UK expansion
• US expansion
• The messy reality of encoding law

Part III: Future

AI implications and what's next.

• LLM limitations (67% accuracy finding)
• Why deterministic tools matter more
• Agents need reliable infrastructure
• Cosilico thesis
• Democratic vs. autocratic simulation
• The choice being made now

File Conventions

Manuscript Files

• Named: NN-title.md (e.g., 01-introduction.md)
• Start with # Chapter Title
• Use ## Section headers
• Wiki-links to research: [[concept-name]]

Research Notes

• Named: kebab-case.md
• Have metadata section at top
• End with ## Links and ## Tags

Chapter Template

# Chapter Title

[Opening hook - story, question, or surprising fact]

## Section One

[Content with [[wiki-links]] to research]

## Section Two

[More content]

---

## Research Links

- [[relevant-concept]]
- [[relevant-person]]

Navigation Commands

When asked about the book:

• "Where does X fit?" → Check outline above
• "What's in Part II?" → Building section
• "Show chapter structure" → List files in manuscript/

Current Status

Check .beads/ for project issues and progress tracking. Use bd list to see open items. Use bd ready to see what's ready to work on.

Key Relationships

• Introduction sets up Rehoboam/Serac contrast
• Part I establishes what microsimulation IS
• Part II shows how it became OPEN
• Part III shows what's NEXT (with Cosilico launch)
• Ending returns to Serac: "What if Rehoboam were open source?"