klappy.dev

The RecordPrinciples

Status Carries Three Tenses

Was, Is, Will Be, Each With an Observed Time and Its Confidence, Proximity and Relevance

Simple Rules

  • Use when: Use when any message, document or contract states what exists, existed or will exist — status, release note, roadmap, demo, sales claim, handoff, schema.
  • Skip when: Skip for claims with no state in them — a definition, a question, a pure opinion.
  • Stop when: Stop when a reader who missed the last stretch can place every claim as was / is / will be, each with its time, confidence, proximity and relevance (see The Test).
  • Keep going when: Keep going while any claim could be read in two tenses or any "will be" lacks its gate.
  • Where: Captain-facing and agent-facing surfaces, including agent-to-agent contracts and schemas; rendering rules live in canon/constraints/legibility-standard (Three Tenses amendment).
  • Who: Whoever makes the claim, human or model; a reviewer checks tenses before content.
  • Why: An expectation has no footing without a place in time (klappy://canon/values/trust-kernel).
  • What: Three tenses, each with observed time plus confidence, proximity and relevance; timelines cut at natural snapshots (Three Axes; Each Tense Is a Timeline).
  • How: Observe before stating, stamp what you read, carry the path from what the reader holds to now and from now to the gate the decision waits on (Constraints).

SummaryExpectations Live in Time, So Status Must Too

Trust is built by managing expectations (klappy://canon/values/trust-kernel). An expectation is always about a state at a time: it was red at nine, it is green now, it will be on production after the next train. Remove the time and the expectation cannot be checked; remove the tense and the reader cannot tell a memory from a report from a promise. Both removals are expectations failures, and both produce the same symptom in the reader: they stop trusting the reporter, however accurate each individual sentence may have been.

Models make this failure easily. A session that watched a gate turn red remembers "red" and repeats it hours after the gate turned green, because nothing in its context stamped the observation with a time (klappy://canon/observations/time-blindness-axiom-violation). A reporter who mixes the old screenshot with the new one, or the merged change with the proposed one, forces the reader to reconstruct the timeline themselves — and the reader was the bottleneck already.

The fix is structural, not stylistic. Every status names what was (and when it was observed), what is (and when that was observed), and what will be (and when it is expected, with what gate decides it). A tense with no observed time is marked as such — "not re-checked since 09:41" — rather than silently carried forward.


The Three Tenses

TenseCarriesTime it carriesFailure when missing
Wasthe prior state the reader may still holdwhen it was last observed to be soa stale state is re-reported as current
Isthe state nowwhen the reporter last observed ita memory is passed off as an observation
Will bethe next state and the gate that produces itwhen it is expected, and what decides ita plan is read as a result

One line is enough when all three fit: main was red at 23:05 (release gate), is green since 06:05 (checked 09:41), will be on production after the next deploy, which the deploy gate triggers. Several lines are fine when the reader must compare before and after. What is not fine is a single present-tense sentence that could belong to any of the three.


Three Axes Compound on Time — Confidence, Proximity, Relevance

Past and future are not one thing each. Every point on either side of now carries three independent measures, and a status that names the tense but not the measures still misleads. The captain named all three on 2026-10-09 and asked that they not be conflated.

AxisQuestion it answersWasWill be
ConfidenceHow is this known?observed by the reporter · observed by a tool whose output the reporter read · recorded in a ledger or log · reported by another seat or person · remembered from earlier in the session · inferredcommitted and gated · planned, with evidence it is on course · planned on track record alone · proposed, awaiting a ruling · hoped, no commitment
ProximityHow far from now?seconds ago · this session · last release · releases agonext train · this release · a few releases out · the vision
RelevanceHow much does it bear on this task?changed what the reader holds now · context the reader never acted on · unrelated to this taskthe gate this decision waits on · the horizon the decision reaches · the roadmap beyond it

The axes are independent. A hoped feature can be near ("we want it in this release") and a committed one can be far (contracted for next year). "It was green" read from a CI badge an hour ago and "it was green" recalled from a colleague's message yesterday differ on confidence and proximity; both may be irrelevant if the reader is deciding about a different gate. Collapsing the three into one word — "soon", "basically done", "we had that" — is how a hoped "will be" gets delivered at the is tense, which is the sales failure named above.

Naming an axis can be one word or the time and source that imply it: "observed 09:41" carries confidence and proximity; "the gate your yes is waiting on" carries relevance.


Each Tense Is a Timeline, and Relevance Chooses the Points

"Was" is not one state and neither is "will be." The same thing can have a dozen past states — a gate that went red, green, red, green in twelve hours; a screen tweaked pixel by pixel for two hours — and a dozen future ones — the next train, the deploy after it, the field test, the release milestone. A status that reports one "was" and one "will be" has already chosen, and the choice is where expectations are managed or lost.

The filter is relevance to the reader's current moment and current task, and the default cut points are the natural snapshots:

TenseCarryDefault snapshotsLeave behind an exit
Wasthe state the reader last held, and the path from it to nowbefore this working session · the last release · the release before thatevery intermediate tweak; states the reader never acted on
Isthe current state, with its observed time and confidencenowdetail the current decision does not need
Will bethe next gate and as many beyond it as the current decision reachesthe next train · this release · the nextthe roadmap past that horizon

Two readers of the same thing get different statuses. The captain who last saw the gate red at 23:05 needs "went green 06:05, still green 09:41"; the cook who watched it turn green needs only "still green 09:41." A design review after two hours of tweaking needs three frames — before the session, the last release, now — not two hundred screenshots. The reporter's job is to know which state the reader is still holding — the ledger and the last message to them say so — and to carry the path from there to now, then from now to the next decision.

What relevance does not permit: dropping a transition because it is embarrassing, or carrying a far-future state because it is attractive. The horizon is the task's, not the reporter's.


What This Is Not

  • Not the epistemic modes. Exploration, planning, execution and validation are linear stages of work with their own time dimension; the three tenses apply inside any of them. A validator reports was/is/will-be as much as a builder does.
  • Not a version scheme. Release identifiers are a cross-section of this principle, strongest for the past and present: a released version is a trustworthy snapshot of was and is. The future stays loose by design — ship when the gate passes, cut a patch when the fix lands, do not pre-number what has not been built — so "will be" is anchored by gates, not by version numbers promised in advance.
  • Not a skill. It is a lens applied across skills, methods, contracts and schemas, including the contracts agents write to each other between layers.

Why This Derives From the Trust Kernel, Not From Time Blindness

Time blindness explains how a model loses the clock. This principle states why the lost clock costs trust and what a status must carry regardless of who writes it. A human reporter with a perfect clock who writes "the gate is red" without a time has broken the same expectation: the reader cannot tell whether to act. The axioms supply the mechanics — observe before claiming (Axiom 1), do not imply what you did not verify (Axiom 4) — and the kernel supplies the reason (klappy://canon/values/trust-kernel): an unplaced status is an expectation that was never set.


Observed Across RolesThis Predates Models

The captain's account (2026-10-09): as founder, inventor, lead developer, architect, CTO and sales engineer, he repeatedly watched sales and leadership sell what the product would be and claim it already was. The person responsible for making it true carried the gap. The outcomes were the same every time the tenses collapsed: lost clients, rework, frustrated users, angry funders, lost funding. When the tenses were kept — what is shipped, what is building, what is promised, each with its date — the same products kept their clients and their funders. In his judgment this is probably the root communication concern of product development, which is why it lives here as a principle and not as a style note for model output.

The model failure in the next section is one instance of a human pattern, not a new problem.


Evidence

2026-10-09 (America/New_York), FIA app cookbook session. The first officer asked the captain a yes/no in the morning that the captain had answered at 23:17 the night before, and reported the main branch "red" when it had been green for three and a half hours. Each sentence had once been true. Neither carried the time it was true. The captain's response named the cost: when a report cannot distinguish past, present and future, the collaboration is bankrupt however good the work underneath — and the principle, in his words, hangs on the trust cornerstone.


ConstraintsWhat This Principle Requires and Prohibits

  • A status with no tense is not a status. Rewrite it until a reader can place each claim as was, is, or will be.
  • A tense with no observed time is marked unobserved, never inferred from context or from the last time the reporter looked.
  • "Will be" names the gate that produces it, so the reader knows what to watch rather than when to hope.
  • Each point in a tense names its confidence (observed, reported, recalled; gated, planned, hoped) and its proximity (when), by a word or by the time and source that imply them. A bare tense is read at the strongest confidence and the nearest proximity, which is the reporter's lie by omission.
  • Each tense is a timeline. The status carries the past states from the one the reader last held to now, and the future states as far as the current decision reaches — chosen by relevance to the reader's moment and task, never by comfort.
  • A before/after presentation keeps the two states visibly separate; one frame per state, never interleaved.
  • This is a principle (why), not a format (how). Methods and operating contracts choose the line shape; they may not drop a tense or a time.

The Test

If a reader who missed the last twelve hours can read one status and know what changed, what stands now, and what to expect next — and when each is true — the principle is satisfied. If they must ask "wait, is that still the case?", it is not.

Markdown · RSS · built from klappy/klappy.dev@b750d7d