Five Questions I Ask the Project Record
Format: field noteEvidence: in daily use

I use the project record when the next coding decision depends on work outside the current conversation. The record can bring back an earlier rationale or show that a new-looking failure has already occurred across several tasks.
In WorkBay, I look up decisions, findings, test records, or blockers according to what the current task needs.
Project Memory Outside the Conversation explains how those records are stored and retrieved.
Where does trouble repeat?
A review usually concerns the work in front of it. A sequence of reviews can reveal trouble that keeps returning across tasks. The project record makes that sequence available even when no single session has seen all of it.
In my summary of an earlier audit, roughly three quarters of the recorded reviews in a small project had failed. The audit date, review count, and underlying rows are not available here; this remains an author-reported observation. That pattern prompted a closer look at the architecture. The count did not establish the cause: task selection and review practice could also have affected the proportion.
I inspected the findings behind the count to see whether they shared a constraint or arose from different causes. The proportion directed that investigation; the findings had to support the diagnosis.
Does a useful fix already exist?
A new finding may resemble a problem recorded under different wording. Semantic retrieval—searching by similarity between numerical text representations—can surface an earlier resolution, which a human or agent can compare with the current code.
The resolution may contain more than a patch. It can preserve the constraint that made the patch necessary or the reason a simpler change failed. That explanation helps determine whether the earlier fix applies now.
An earlier fix remains a candidate until its conditions and recorded status have been checked. Copying the patch without that check would replace repeated investigation with a different risk: applying the right answer to the wrong problem.
Why was this approach chosen?
A decision record preserves the reasons behind a choice. Those reasons give a later discussion a starting point even when the people or tools involved were absent from the original conversation.
For example, a later session may question why a site uses static output rather than server rendering. The recorded rationale can identify the requirements the choice addressed. Those requirements can then be compared with the needs of the current work.
A changed requirement may justify a changed decision. The record should make that change deliberate, not keep the original choice closed forever. Its value is distinguishing a new reason from an old debate whose reasoning has been forgotten.
What supports the completion claim?
A completion claim needs evidence tied to the work being assessed. In my WorkBay workflow, review verdicts (the reviewer’s pass or fail decision) and test records sit alongside task and commit information. A commit identifies a particular revision of the code. That information lets another reviewer inspect which commands ran, what they returned, and which revision they concern.
The revision matters because a test result from earlier code does not automatically establish the state of the current code. A useful review follows the evidence back to the change instead of relying on a summary saying that the task passed.
A second model can be given that evidence without inheriting the author’s conversation. Independence of the conversation does not guarantee a correct review; the reviewer still needs to examine the changed code and the relevant checks. Semantic search may help locate the relevant discussion, but the completion assessment depends on the exact records and the code.
What has already failed?
A failed approach leaves information that can disappear from a recap of the eventual success. Blockers and abandoned attempts preserve that information, including why the approach was set aside.
The reason distinguishes an option that was temporarily unavailable from one that produced incorrect results. An unavailable dependency may later become usable. An incorrect result may expose a constraint that still applies.
The history therefore does not forbid another attempt. It makes the next attempt answer a specific question: what has changed since this failed?
From a useful lookup to an evaluated benefit
My use of these lookups has not established how often retrieval finds the right material or how much work it saves.
Testing Whether Project Memory Saves Work proposes a comparison of task effort and quality to evaluate that benefit.