Change Control · CHI

One controlled path for every change.

Ledger artifacts change through exactly one path: a Change Intention. A developer or an agent declares what they want to do, and every Change Intention goes through Design Review.

Change Intention · Paymentsproposed Ledger change
StepItemState
ActorDeveloper or agentDeclared
IntentAdd a second payment providerProposed
DeltaLedger changes this would causeIn review
ReviewDesign Review, human onlyApproved
Illustrative mock. Not an actual product screen.
What’s in it

Three parts, one gate.

Change Intention

A proposed transition, declared by an actor. A candidate, not a mutation.

Design Review

A human-only gate, much like a GitHub pull request.

Main branch of design

Where approved changes merge.

How it works

From intent to the main branch of design.

01Declare

An actor says what they want to do. rkito captures it as a CHI.

02Propose

rkito proposes how the Ledger should change as a result.

03Review

Design Review is the only function that can authorise the change.

04Merge

Once approved, it merges into the main branch of design.

Where it is used

Before code, and at the PR.

ConceptDesign Review vs. Code Review

Code review asks whether code passes. Design review asks whether a decision conforms to intent.

EssayChange Intention: the missing primitive

Agents generate code that compiles and still violates a boundary someone drew three sprints ago.

Prepare the ground now. Switch on the gate later.

Starter is free for five members. No credit card.