lenia-swarm docs

Use this map to navigate Lenia Swarm research framing, contracts, internals, and decisions.

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.

Use universe for research framing, contracts for durable interfaces, and internals for implementation details.

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