This directory contains Architecture Decision Records documenting key architectural decisions in Morphogen's development.
An ADR captures:
- Context: What problem we're solving
- Decision: What we decided to do
- Consequences: What the decision means for the project
ADRs explain why decisions were made, not how to implement them (see Specifications for implementation details).
Establishes Morphogen's unified reference model for cross-domain simulation.
Defines patterns for integrating multiple domains in a single system.
Decision to add circuit modeling as a first-class domain.
Decision to add audio instrument modeling capabilities.
Adds emergence and complex systems simulation domain.
Decision to support chemistry and chemical engineering workflows.
Major paradigm shift: GPU-first execution for certain domains (BI domain).
Adds procedural content generation as a core domain.
Adds ambient music generation and generative audio domains.
Establishes naming conventions and branding for the Morphogen ecosystem.
Renames Kairo → Morphogen (honoring Turing's morphogenesis work) and establishes Philbrick as the analog hardware sister project.
Defines patterns for translating concepts between domains.
Consolidates audio/music domains into unified architecture.
Addresses technical debt and complexity in the codebase.
ADR-015: First-Class Emergence Primitives (Proposed)
Promotes attractors, constraints, time-scales, noise typing, and phase transitions to first-class status. Establishes the design principle: "Promote to first-class whatever the system stabilizes into—and whatever constrains what can stabilize."
Note: This directory was recently reorganized (2025-11-15) to fix numbering collisions:
- Previously had two files numbered "003" and four numbered "005"
- ADRs have been renumbered sequentially
- The "multiphysics success patterns" document was moved to Reference as it's a patterns catalog, not a decision record
All file history has been preserved using git mv.
- Implementation details? See Specifications
- High-level architecture? See Architecture
- How to implement? See Guides
- Battle-tested patterns? See Multiphysics Success Patterns