Browse documentation

Intent and plan records

Stable IDs, human-readable Markdown, and UTC decision instants.

Template 2.1.0

Intent fields

FieldMeaning
idWorkspace-global intent ID, such as i001.
created_byAuthor's member ID; the only member-related metadata.
created_atCreation instant.
plansLinked implementation plans.
approved_atPresent after a person's approval is recorded.

The body holds goal, non-goals, constraints, success criteria, repository scope, and numbered open questions. The approval note retains the person's exact words.

Plan fields

FieldMeaning
id, created_by, created_atIdentity and author.
intentThe approved outcome this plan implements.
repositoriesLogical implementation repository IDs.
depends_onOptional plan dependencies.
completed_atPresent after requested completion.

The body describes approach, tasks and order, risks, and checks. Execution does not rewrite the plan; the result is carried by the completion note.

IDs, dates, and language

Intent IDs have at least three digits; plans have at least four. Allocation reserves IDs permanently, including after archival. Use returned IDs rather than guessing the next number. Distinct member bands can separate offline allocation ranges, but a local lock is not distributed coordination.

Instants use 2026-09-15T10:53:00Z; other dates use YYYY-MM-DD. Record prose follows the author's language, headings stay English, and decision notes preserve the person's words exactly.