Schema

Files directly in this folder are the current data contract.

• Feature Sets propose changes via feature-sets/<slug>/schema-changes.md. Once the gate is signed, this folder is updated to match and the proposing delta file's frontmatter status flips to applied.
• Schema documented outside the Feature Set flow (e.g. reverse-engineered from an existing app) goes directly into this folder with status: applied and derivation: reverse-engineered in its frontmatter — no separate pending holding area. If it needs review, that happens via a normal PR against the file, same as any other change.

Do not read feature-sets/<slug>/schema-changes.md as current state — only files directly in schema/ are current. schema-changes.md is a historical or in-flight record of how we got here.