singularity-forge/docs/dev/sf-runtime/state.md
2026-05-14 19:32:41 +02:00

538 B

name description
sf-state Use when changing SF state ownership, DB-first runtime state, generated artifacts, or .sf/.agents boundary rules.

SF State

Use this for SF state-boundary work in this repository.

Rules

  • .sf/sf.db is the canonical structured runtime store.
  • .sf/ runtime files are generated projections, logs, recovery inputs, or caches.
  • .agents/ is repo-owned agent overlay configuration, not runtime state.
  • src/resources/ owns bundled SF defaults.
  • Do not commit generated .sf runtime churn.