Pre-release documentation

This is a decision model, not a prediction. The pinned evidence does not compare project outcomes with and without Coldstart.

Use Coldstart only when its recurring ceremony addresses a recurring cost you can name. If one short instruction file and ordinary tests handle the weekend app, keep them. If the long-lived order app repeatedly pays for rediscovery, scope drift and weak handoffs, trial the smallest part of the workflow aimed at that pattern.

Start with what actually happened

The weekend app is maintained by one person. Its purpose is stable, handoffs are rare and a lost convention is cheap to recover. A README note, a few tests and version history already leave a reasonable trail.

Adding a formal plan, current-state pointer, filing rules and close routine would create new work. If those habits do not address a repeated problem, they are overhead.

The order app has a different history. Fresh sessions have reconstructed which CSV fields were approved. A background-job idea has returned after being rejected. One handoff failed to make the authorization result obvious, and historical-ID work once tried to enter the active export change.

Here the manual workflow is still competent: search the repository, read version history, keep a notes file and ask the maintainer when intent is unclear. Its friction is repetition. The same reconstruction and steering costs return across sessions.

Name the pain before choosing the machinery

Look for incidents, not slogans:

  • A fresh session repeatedly reconstructs a decision that should be findable.
  • A request repeatedly expands into adjacent work without an explicit choice.
  • A consequential change proceeds without surfacing a human decision.
  • A handoff calls work complete without naming what was checked.
  • Obsolete guidance or a rejected approach repeatedly returns as current.

One awkward session is weak evidence for a permanent operating layer. Try the narrow repair first: improve one instruction, add one relevant test or record one load-bearing decision.

Coldstart should not manufacture its own need by calling every imperfection drift.

Count the continuing cost too

A current plan has to be revised when evidence changes. A pointer has to lead somewhere useful. Durable facts need owners. Checks must represent the failure they claim to detect. A closeout has to carry information the next session needs.

These habits can become empty ceremony: a plan nobody updates, a long handoff nobody uses or a green check aimed at the wrong condition. More structure is not automatically more control.

Cost already paidCandidate habitOngoing cost to inspect
Reconstructing the approved export fieldsGive the decision one durable owner and link it from current stateKeep that owner current
Historical-ID work entering the CSV sessionKeep an open-work queue outside active scopeReview and drain the queue deliberately
Unclear authorization handoffName the check and result before closeMaintain a check that answers the real question

The candidate habit is justified only while it costs less than the repeated problem it addresses.

Trial one hypothesis

Do not trial “better agent work.” Choose an observable question. For the order app:

Can a fresh session locate the approved CSV decision and the current authorization state without reconstructing them from chat?

After several real sessions, inspect both sides:

  • Did the chosen failure recur, become easier to detect or become easier to recover from?
  • Did the plan and handoff help the next session, or merely add text?
  • Did the check answer the intended question?
  • Which habits earned their upkeep, and which should be removed?

This local trial can guide the maintainer's decision. It still does not prove how another project or team will fare.

What the pinned evidence contributes

The reviewed product includes named checks, a partly walked smoke record and authored cases for selected mechanisms. That evidence can show that a detector responded to its represented defect or that a selected query reached the expected item in a bounded set.

It does not compare otherwise similar projects with and without Coldstart. It establishes no general productivity, code-quality, error-rate or return-on-ceremony result.

The maintainer owns the balance. A repository check can report a represented condition; it cannot decide whether that condition matters enough to justify a permanent habit.

Next

Now apply the stop bar to the product's own language: what Coldstart does not claim.