SIMMIS GUIDE

concept reference

The small vocabulary needed to discuss Simmis precisely, plus a map of which component does what.

core vocabulary

Basis
The exact version of accepted managed state from which a task or branch begins.
Branch
Isolated, copy-on-write state that can diverge from its basis without changing the parent.
Composite branch
A branch that coordinates versioned knowledge, files, and relevant execution context from one basis.
Team and room
A Team is the persistent product context for people, agents, shared material, and history. A room is its Dvergr runtime context.
Accepted managed state / main
The currently accepted state managed by Simmis. Developer interfaces may call the branch main.
Proposal
A branch packaged for review with its changes, rationale, provenance, and cost.
Semantic diff
A description for reviewers of what meaningfully changed across facts, files, or outputs.
Provenance
The chain connecting an output to its basis, agent, tools, sources, and run history.
Merge and discard
The review decision determines whether to merge a proposal into accepted managed state or discard the attempt without changing its parent.

component map

ComponentResponsibilityPlain language outcome
SimmisProduct, shared work, proposals, reviewAttempts remain separate from accepted managed state until an authorized decision makes them official.
SpindelReactive interface and execution contextLive work keeps the context needed to explain and resume it.
DvergrRooms, agents, tools, schedules, budgetsAn agent works inside explicit operational bounds.
Kabel + YggdrasilSynchronization and composite branchingAn attempt can diverge without quietly changing its parent.
Datahike + KonserveVersioned knowledge and durable storageShared memory keeps history instead of overwriting it.

how status words are used

  • Working now means the capability exists in the current system, although documented limits may remain.
  • In progress means active product work. Do not plan as though it has shipped.
  • Planned means intended work that is not yet in active delivery.
  • Research explains design intent, not a product commitment.