OPFiles.ai

The model

Source, view, and drift gate

The source leads to the view: every view is regenerated from its declared sources, never edited by hand. Configured as a required commit or CI check, the gate re-renders and compares the bytes; if the source and the view disagree, the build fails.

Model

Sourcebacklog_item.index.tomlmachine-written TOMLgenerateViewBACKLOG.mdgenerated, human-readablecompareDrift gateopf render --checkregenerate and diffthe gate re-renders the view from its declared sources and compares the bytesSourcebacklog_item.index.tomlmachine-written TOMLgenerateViewBACKLOG.mdgenerated, human-readablecompareDrift gateopf render --checkregenerate and diffthe gate re-renders the view from itsdeclared sources and compares thebytes
Figure 1. The source is what your tools and assistants write; the view is what your people read. When configured as a required check, a gate compares the view with a fresh render of its sources.

In 1 file

Edit the source. Run the renderer. Check the view.

.working/toml/backlog_item.index.toml

schema = 1
[[record]]
id = "BI-1"
type = "backlog_item"
status = "active"
title = "Add the drift gate to CI"
created_at = "2026-09-01T14:02:11Z"
updated_at = "2026-09-04T09:37:48Z"
actor = { kind = "assistant" }

.working/BACKLOG.md

Generated by opf render --write from backlog_item.index.toml and block.index.toml. Do not edit; edit the store and regenerate.

BACKLOG

  • BI-1activeAdd the drift gate to CIactionable

Illustrative excerpt. You edit the TOML. The Markdown is generated. When configured as a required check, the gate compares the view with a fresh render of its sources.

In the box

What is in the box

12baseline record types
13generated views
10command verbs

The specification defines 12 baseline record types and 10 command verbs; the reference scaffold declares 13 generated views. The record types are 11 typed indexes plus the worklog ledger, each with a closed schema that refuses what does not fit. The scaffold declares 12 Markdown views and 1 TOML projection. The verbs: init, adopt, import, doctor, render, migrate, sync, upgrade, absorb, record.

Limits

What the checks establish

Schema validation and drift checks are intended to catch structural defects; they do not establish that a record's claims are true. Review recorded claims against their evidence.