lenia-swarm docs

This dossier uses a three-lane docs system so readers can choose depth without mixing concerns.

Lanes

• universe/: conceptual language, ontology, interpretation, and research framing.
• contracts/: executable interfaces and guarantees (CLI, schema, artifact layout, reproducibility rules).
• internals/: implementation details tied directly to source files.
• decisions/: ADRs that capture the rationale for durable structure choices.

Rule of separation:

• Universe docs do not define CLI flags or SQL migration mechanics.
• Contract docs do not carry speculative worldview language.
• Internal docs do not serve as onboarding narrative.

Start Here

• Primer
• Glossary

Universe

• Physics
• Morphology
• Ecology
• Taxonomy

Contracts

• LocalCLI
• ResearchModes
• CompendiumSchema
• MorphometricsAndTraits
• EcologyCLI
• ArtifactLayout
• Reproducibility

Internals

• FlowLeniaImplementationMap
• PaperGroundedLanes
• IndexerInternals
• StudioCompendiumInternals

Reading Paths

Research orientation:

1. universe/Primer.md
2. universe/Physics.md
3. universe/Morphology.md
4. universe/Ecology.md
5. universe/Taxonomy.md

Run and operate:

1. contracts/LocalCLI.md
2. contracts/ResearchModes.md
3. contracts/ArtifactLayout.md
4. contracts/Reproducibility.md
5. contracts/CompendiumSchema.md

Implement and debug:

1. internals/FlowLeniaImplementationMap.md
2. internals/PaperGroundedLanes.md
3. internals/IndexerInternals.md
4. internals/StudioCompendiumInternals.md