Skip to content

State Sync Self-reference

State sync documents should not create circular claims that become true only because a later summary repeated them.

Self-reference drift happens when generated state is re-ingested as authoritative source without preserving the original provenance.

  • Keep source references explicit.
  • Separate generated board summaries from source repo state documents.
  • Rebuild generated content from the source repo, not from prior generated board output.
  • Prefer deterministic parsing over narrative reuse.

Generated content under src/content/docs/generated/ can be deleted and rebuilt at any time.