estimated visitors
Architecture deep dive · 2 MIN READ
The Escape Hatch Is Part of the Architecture
Org compatibility, lineage, and shared operations make portability a first-class feature.
Your notes should have a way out
ProjectMan starts with a practical promise: Org text should survive parsing, database storage, and rendering in a stable canonical form. Org-mode remains a durable representation of the work, so richer application features do not trap planning data inside one interface.
Stable identity around portable text
The database adds stable identity, ordered hierarchies, multiple notebooks, structured scheduling, lifecycle state, source evidence, and point-in-time history. Bronze records preserve what arrived, Silver models validated current state and versions, and derived Gold-style projections can be rebuilt. Lineage connects a visible heading or projection back to the import and transformation that produced it.
Portable text, traceable transformations
The layers preserve source evidence, validated state, and rebuildable views. Org remains a durable way to represent the work.
flowchart TD
Org[Org source] --> Bronze[Bronze source evidence]
Bronze --> Silver[Silver state and history]
Silver --> Gold[Derived views]
Silver --> Export[Org export]
Keep domain rules in one place
All interfaces share the same domain operations. The workbench, REST API, CLI, and MCP adapter do not each invent their own rules for moving, clarifying, scheduling, or completing work. Requests pass through common validation and audit boundaries, making automation easier to inspect and preventing interface-specific shortcuts from silently corrupting the underlying hierarchy.
Privacy follows the data through these layers. Agent- and client-facing surfaces default to safe projections, while unrestricted history and source evidence require a bounded, higher-trust path. Model-assisted workflows exclude ineligible private material before a provider call, generate an ephemeral draft, validate its shape, and apply it only through the established operation kernel. Portability, provenance, privacy, and human review are treated as product features rather than cleanup work.
PROJECT
