Governance flow

Governance is the ledger of intent: what you chose to defer, what you decided, and how signed records change without losing their history. It is what lets a workspace stay accountable across months and many agents.

gov pending create → register   →   deferred work, tracked
        │
gov decision create             →   a choice, recorded with rationale
        │
gov amend <artifact>            →   append-only change, no re-sign

Defer work

seif gov pending create   # skeleton in .seif/modules/pending/
seif gov pending register # register into the global backlog
seif gov pending list     # what's outstanding (this workspace + owner-targeted)
seif gov pending consume   # mark done when satisfied

A pending is a promise the workspace keeps for you — surfaced at session start until it is consumed, so nothing important quietly falls off.

Record decisions

seif gov decision create   # a SEIF-DECISION-v1 module

Decisions are first-class artifacts; bind them to a cycle with gov cycle decision-add so the rationale travels with the work.

Amend without re-signing

seif gov amend <artifact.json> --entry '{...}'

Signed SEIF artifacts are never rewritten. Changes append to an _amendments[] list — the original signature stays valid and the full history is preserved. This is how a record evolves without the original signer having to re-sign.

Where to go next

• Cycle flow — the unit decisions and pendings feed.
• Provenance flow — signing the artifacts you govern.