Leverage AI

The Deliberation Is Source: The Document Is the What, the Conversation Is the Why

📖 This article has an expanded ebook edition — read the full ebook.

In AI-assisted knowledge work the conversation that produced an artefact is upstream source and the finished document is compiled output — so an organisation that keeps only its documents has kept the results and thrown away the reasoning.

Scott Farrell · LeverageAI · July 2026 · Deliverable 189

Here is the question that kills the idea before it is examined:

Why should my organisation capture what people say to AI, when we already keep every document they produce?

It sounds responsible. Document control is real. Filing is real. Version histories of Word files, workbooks and decks are real. The trap is that the question assumes the finished artefact is the source of the work. In AI-assisted knowledge work that assumption is false in the same way it has already become false in software: source is relative to the compiler boundary. Relative to publication, the document is source. Relative to the meaning-making process that produced it, the document is compiled output. The conversation that carried intent, rationale, rejected alternatives and uncertainty is upstream.

The final document may be the least semantically useful view of the work.

That line is deliberately counterintuitive. It is also the claim this piece is here to make operational. After reading, you should be able to say what a finished artefact structurally cannot contain — and specify the structured work event every approved AI surface should emit so the organisation keeps the reasoning as well as the result.

The wrong question, restated

Document retention is not the enemy. Document-only retention is. Teams that keep every board pack, every workbook, every deck still cannot answer ordinary operational questions: why an assumption flipped; which option died and for what cause; whether a paragraph is original or inherited; whether a short recommendation was cheap or expensive to produce. Those questions are not exotic audit theatre. They are how institutions learn, how managers unstick work, and how agents later reconstruct what a prior session meant.

The incumbent mental model is simple: the polished artefact is the work product and therefore is the knowledge asset. Filing systems, document control and “if it is not in the file it did not happen” all reinforce that model. The model fails when the artefact is optimised for an audience that must not see the investigation. Publication is compression with a purpose. Compression with a purpose is not a complete record of meaning-making.

Source is relative to the compiler boundary

In software we already had to learn this once. When intent, prompts, context, tests and starting state can regenerate behaviour, the files we still call “source code” are intermediate representation relative to the package above them. The durable asset is the upstream package — not only the generated files.1 The developer–AI discussion sits at an earlier compiler stage:

human intent and observation → developer–AI deliberation → rejected alternatives and decisions → acceptance tests → generated or edited code → commit and build → deployment → observed production behaviour.

Relative to Python and Git, the .py file is source. Relative to the AI development process, that file is already compiled output from intent, dialogue, context, tests and decisions.1 The transcript is a source map: it carries why the choice was made, what was rejected, what was attempted and which conditions mattered — information the resulting code cannot reconstruct.2

The companion doctrine is sharper still. Code records the final state. The transcript records dated intent, rejected alternatives, and planned but unbuilt work.3 The gap between what you meant and what you shipped is itself information. “Considered X and deferred it” is a project fact no code search can ever return, because a repository can only describe what exists.4

So for understanding a software project, “source” is not one thing. Different layers answer different questions:

A credible project intelligence system preserves those distinctions rather than averaging them into “the project says.” That software stack is established doctrine. What has not been claimed hard enough is the generalisation to the large majority of knowledge work that never touches a repository.

The same cascade for knowledge work

For ordinary knowledge workers the cascade is not prompt → code → deploy. It is:

intent and deliberation → Word document, spreadsheet, presentation, email, decision or plan.

The repository is not the whole source for software. The document library is not the whole source for knowledge work. SharePoint, email and the local drive hold the published state. They do not hold the judgment that produced it.

In AI-assisted knowledge work, the conversation that produced an artefact is an upstream source map. It contains intent, rationale, alternatives, corrections, uncertainty and plans that the final artefact often compresses away.

That is The Deliberation Is Source — the software rule moved to the rest of the enterprise. The Prompt Is Source remains the parent claim for coding agents.1 This piece owns the corporate generalisation: every substantial AI-assisted session that produces or changes a knowledge artefact has an upstream stage worth keeping.

Why the finished document is often the least useful semantic view

Finished artefacts are optimised for audience and purpose. That is a feature of publication, not a defect of the author. It is also why they are a poor substrate for meaning-search:

The AI conversation often says the useful thing much more explicitly:

Those sentences carry verbs, causes, contrasts and intent. They are closer to meaning than the final cells or paragraphs. The final document tells you what survived publication. The deliberation tells you what the person was trying to achieve, what they relied on, what they changed and why, what they rejected, what they remain unsure about, what they intended but never completed, and where they got stuck.

The document is the what. The deliberation is the why.

This is the same code/transcript distinction, restated for knowledge work.3 The finished file is the intersection of intent and publication. The deliberation is closer to the whole set. Everything in the difference — rejects, uncertainty, unbuilt plans, inherited-versus-originated distinctions — lives primarily on the deliberation side.

Proof 1 — side-by-side on one real work episode

Much valuable knowledge work produces little visible output. A worker might spend two days establishing that a proposal cannot work, reconciling conflicting interpretations, locating an undocumented dependency, discovering that three datasets cannot be safely joined, persuading several groups not to take the obvious path, and narrowing a problem until the eventual document becomes simple. The final artefact may be one paragraph:

“Option B is recommended.”

That is not a cartoon. It is the normal shape of high-quality analysis: the investigation compresses into a decision sentence, and the organisation files the sentence. The AI conversation, if captured, holds the value that sentence cannot carry.

What the artefact says

“Option B is recommended for the client operating model. Implementation can proceed under the existing regional structure with a light central coordination role.”

Readable in thirty seconds. Fileable. Almost empty of causal structure.

What the deliberation says

Tried Option A (full centralisation). Rejected: handoff delay outweighs consistency benefit for regional operations. Tried hybrid with shared services hub. Rejected: requires a data join across three systems that cannot be safety-certified this quarter. Confirmed Option B after checking the undocumented dependency on the regional finance calendar. Open risk: specialist capacity in one region is a single point of failure. Next action: need authority for a temporary surge resource, not a redesign.

Now ask which questions only the deliberation can answer:

Question Artefact alone Deliberation
What was recommended? Yes — Option B Yes
What was rejected, and why? No Yes — A and hybrid, with causes
What hidden constraint blocked the obvious path? No Yes — unsafe data join; finance calendar dependency
Where is residual uncertainty? No Yes — regional specialist as single point of failure
What help does the worker actually need next? Guesswork Authority for surge resource, not a redesign
Was this a lazy one-paragraph answer or two days of expensive investigation? Looks lazy Shows the investigation

Read every row. The artefact is not lying. It is doing its job as a decision sentence for an audience that does not want the investigation. The organisation that keeps only that sentence has kept the result and discarded the reasoning. Capturing the deliberation makes invisible work legible: someone investigated difficult alternatives, identified a hidden constraint, saved the team from a poor decision, and may have repeatedly supplied scarce domain knowledge. That improves recognition as well as institutional learning.

Proof 2 — the inherited-content search class

There is a second class of question where deliberation systematically beats the artefact: content that was inherited or copied forward rather than originated in this session.

Imagine a large spreadsheet — dozens of worksheets, years of history, formulas nobody wants to re-author. This week’s session changes one assumption table. Columns C and D are recalculated; everything else is carried forward from last year’s report. A knowledge worker asks, later: what did we change, and why?

Document search sees a sea of numbers and labels. Semantic search over the workbook can surface sheets that look “about assumptions,” but it cannot reliably separate inherited mass from this week’s edit. The deliberation, by contrast, often contains a sentence like:

“This table is inherited from the 2024 report; only columns C and D were recalculated — and we recalculated them because the legal assumption is not approved.”

That single sentence answers origin, scope of change, and cause. It is exactly the class of statement that behaves like a good commit message: a semantic compression of what mattered, before anyone re-reads the full diff of every cell.

Search class demonstration

Query: “What changed in this week’s forecast workbook, and why?”

Over the artefact: high recall of assumption-related sheets and historical tables; low precision on this session’s delta; almost no access to legal-assumption rationale unless someone typed it into a cell comment.

Over the deliberation: direct hit on recalculated columns, inheritance boundary, and causal sentence. The search does not have to reverse-engineer which cells are new; the worker already said it while doing the work.

The point is not that document search is useless. The point is that for inherited-content questions, deliberation is the better semantic index into the artefact — the route map, not a rival source of the numbers themselves.

This is why “we already keep the documents” is an incomplete answer. You keep the bronze of the numbers. You throw away the source map of the change.

Salvage S2 — Claude Code writes better commit messages than you, then reads them instead of the code

The git analogy is not decoration. It is a living public case study of the same loop organisations need for knowledge work. Claude Code is the load-bearing product name here because the claim is about observed behaviour of a real coding agent, not a hypothetical assistant.

Write-side

When an AI coding agent owns the commit step, three things tend to happen that human engineers often resist:

  1. One commit per coherent change. The agent can stop at a natural boundary and record it, rather than batching a day’s work into one opaque blob at 6pm.
  2. The request / change / test relationship is described in the commit. A good message states what was asked, what was altered, and how it was checked — not “fixes” or “wip.”
  3. No resentment of documentation. Humans experience commit hygiene as tax. The agent does not. It will put more care into the message than a tired engineer who knows the code “already explains itself” (it does not).

This is a practitioner observation from sustained use of Claude Code, not a controlled density study with percentages. The shape of the observation is enough: AI produces more and better semantic waypoints because it can commit after each coherent change, does not resent writing the note, and can describe the relationship between request, change and tests.

Read-side

The second half is the half people miss. Later, when you ask what happened — “what did we change last week?” or “have we touched barge-in before?” — the same class of agent often uses the commit history as the shortcut. It does not always dive straight into the full diff or re-read every file. It reads the commit comments. The semantic layer the agent wrote becomes the index the agent consults.

The AI writes better commit messages than you, then reads them instead of the code.

That is the self-densifying property. The same actor writes and consumes the waypoints. Software teams are already living inside a preview of Cognitive Git: denser semantic exhaust, produced as a natural by-product of doing the work, then reused as the primary path into “what happened.” Knowledge work can have the same structure if every substantial AI-assisted session emits an equivalent event.

Proof 3 — the Knowledge Work Commit (implementable)

Every substantial AI-assisted work session should emit a structured Knowledge Work Commit. The Word file remains authoritative for its content. The spreadsheet remains authoritative for its figures. The commit is the semantic route into them — gold that explains where and why, while bronze proves exactly what happened.56

Field What it captures Why it is required
intent What the worker was trying to accomplish Without intent, every change looks like edit noise
context Project, client, process, decision or task Joins the commit to a workstream without reading the file
inputs Documents, emails, data, policies and prior work used Provenance of sources actually relied on
artefacts_affected Files created, read, changed or superseded Points at the authoritative content objects
semantic_diff What meaning changed — not merely which words changed Separates inherited mass from this session’s delta
rationale Why the change was made Causal sentence the artefact usually suppresses
alternatives Options considered and rejected One of the three invisible things repositories cannot hold3
uncertainty Open questions, assumptions and missing evidence Prevents false closure in later reuse
friction Sticking points, dependencies and repeated explanations Mine for friction, not guilt — operating-system problems
outcome Drafted, reviewed, approved, published, deferred or abandoned Status discipline: discussed ≠ decided ≠ published
reusable_learning Something worth promoting to team or organisational memory Feeds the promotion path without dumping every chat into canon7

Filled example (the Option B episode)

intent: Decide operating-model recommendation for the regional client programme.

context: Client operating-model workstream; board paper due Thursday; regional structure in scope.

inputs: Prior-year operating model pack; regional finance calendar notes; three system inventory extracts; operations capacity interview notes.

artefacts_affected: Board paper draft v3 (recommendation section); assumption log spreadsheet (legal + capacity rows).

semantic_diff: Recommendation flipped from “centralise for consistency” exploration to “retain regional structure with light coordination.” Assumption log: legal centralisation premise marked not approved; capacity risk elevated for one region.

rationale: Full centralisation loses to handoff delay; hybrid hub blocked by unsafe cross-system data join this quarter; Option B is the only path that survives both operational and data constraints.

alternatives: (A) Full centralisation — rejected, handoff delay. (Hybrid) Shared services hub — rejected, data join cannot be safety-certified this quarter.

uncertainty: Single-point specialist capacity in one region; surge resource authority not yet secured.

friction: Undocumented dependency on regional finance calendar discovered mid-analysis; three datasets looked joinable and were not.

outcome: Drafted recommendation in board paper; awaiting sponsor review; not yet approved.

reusable_learning: Do not propose shared-services hubs that assume a three-system join without an explicit data-safety gate; finance calendar dependencies should be checklist items on operating-model work.

A reader could implement this next week as a JSON or YAML object emitted at session end, a form filled by the agent before close, or a distilled brief written by a cheap model over a stripped transcript.8 The schema is the contract. The storage format is secondary.

What the organisation currently throws away

Be precise about the loss. When an AI-assisted session ends and only the uploaded document is retained, the organisation systematically discards:

Those are not “nice to have notes.” They are the three invisible things software teams already learned to name in transcripts — intent, rejected alternatives, never-built plans — plus the knowledge-work specials of uncertainty, friction and inheritance.3 An organisation that files only the polished output has performed involuntary compression: it kept the publication-optimised residue and deleted the meaning-making process.

Why now matters. Enterprises are currently choosing between blocking AI entirely on privacy grounds and letting conversations disappear into retail tools. Both choices fail the source test. Blocking freezes capability. Retail capture freezes reasoning outside the company’s reach. The window in which a common emission contract can be specified — before a dozen unjoined surfaces proliferate — is open now and closing. The software world already has a preview of the self-densifying loop in Claude Code’s commit write/read behaviour. Knowledge work can install the same contract without waiting for a perfect management dashboard or a perfect version-join resolver.

The one architectural contract that matters

Enterprises do not need every AI tool to share a UI. They need every approved surface to emit the same structured work event.

That may include a corporate chat and research tool, Office assistants, departmental agents, coding tools, document-review agents, and meeting assistants. Named products differ. The emission contract should not. Without it, conversations die in retail tools or sit in unjoined log files — exactly the failure mode already visible when teams treat chat as disposable and the document library as the whole memory.

Raw AI sessions remain bronze: detailed, first-person, high-fidelity, noisy. Not everything is promoted into the active institutional wiki. The raw session is the episodic staging buffer; the institution’s semantic record is the governed layer above it.7 A deterministic strip can remove tool chatter; a model can produce a compact session brief; the Knowledge Work Commit is the searchable semantic header. Keep the bronze so later passes can re-open the full record when the brief is not enough.69

Those commits then join the mesoscale layer that sits between transient chat and permanent institutional canon — the Engagement World of a project or workstream: what the group has currently learned, proposed, rejected, built and verified.10 Different actors can write from different surfaces without perfect memory of one another’s sessions.11 How a session is joined to a specific artefact version is a real problem — and it is a separate problem. A forthcoming companion owns the deliberation–artefact join. This piece owns why capture is worth doing at all.

Cognitive Git, and what this is not

Name the whole pattern without turning it into a product pitch:

A credible worked example of that gold-addresses-bronze discipline already exists in the near-present: gold pages routing an agent into yesterday’s development deliberation so that figures and rationale still living only in bronze can enter today’s thought. That descent is owned as a case study elsewhere; use it as existence proof that deliberation-as-source is not speculative architecture.5

What management does with the aggregate of these captures — weekly cognitive-state views, friction maps, capacity hypotheses — is also real, and also not this piece. A forthcoming companion owns the management product. Here it is enough to insist on the framing: mine for friction, not guilt. The useful organisational question is where capable people repeatedly hit operating-system problems, not who is “slow.” Soft exhaust can reveal blockers, repeated specialist pulls, reopened decisions and invisible investigation. Used well, the default response is help, clarity, resources, redesign — not a scoreboard.

Privacy, consent and employment-law mechanics matter. They exist. They are not designed in this article. The brief here is source-relativity and the emission contract, not the HR regime.

Traditional systems already see outcomes: tickets closed, documents published, milestones green. The soft layer holds the causal explanation — objections, trade-offs, workarounds.12 AI conversations make that causal layer more structured at birth: people state intent, compare alternatives, mark uncertainty, and name what failed. You are not only mining historical exhaust. You are creating an environment where high-quality semantic exhaust is produced continuously as a by-product of doing the work — the same self-densifying loop Claude Code already demonstrates on the write side and the read side of git.

BI over work itself — without building the management product here

Once commits exist, soft data stops being an accidental residue of email and starts looking like a continuously emitted causal layer. Traditional systems see outcomes: tickets closed, documents published, milestones marked green. The soft layer holds objections, trade-offs and workarounds that produced those outcomes.12 AI sessions often pre-structure that layer: “here is what I am trying to achieve,” “that approach failed because…,” “compare these three alternatives,” “this is still unresolved.”

That is why the corporate upside is larger than “archive chats.” It is a path to organisational memory of meaning-making — provided you keep bronze sessions, emit Knowledge Work Commits, and promote only what deserves to become team or firm canon.7 What a senior manager’s weekly compiled view should look like in product form is a forthcoming companion’s job. The source-relativity argument does not depend on that product existing first. It depends on not discarding the feedstock.

First-week pilot

If you want a calendar, not only a philosophy: Day 1 choose one approved surface and wire the Knowledge Work Commit fields. Days 2–3 force emission on every substantial session and repair empty alternatives and outcome fields. Day 4 run the inherited-content trial on a real workbook or recycled proposal and write down which questions only the deliberation answered. Day 5 run the invisible-work trial, fill one commit to Option B completeness, and show both trials to a sceptical peer. If the week ends with commits nobody reads, schedule a habit: start “what moved” questions from commits first and artefacts second. That is how the Claude Code read-side half begins to appear outside engineering.

What to do with this on Monday

  1. Stop treating the document library as the whole knowledge base. It is the object store for published state. Meaning lives one compiler stage earlier.
  2. Pick one approved AI surface (not ten) and define the Knowledge Work Commit fields above as required emission at the end of every substantial session.
  3. Keep raw sessions as bronze. Distil for search; do not delete the source map because the brief is prettier.9
  4. Run one inherited-content trial. Take a workbook or proposal that is mostly reuse. Ask “what did we change and why?” over the file alone, then over the session. Record which questions only the second answered.
  5. Run one invisible-work trial. Find a short recommendation that cost days. Side-by-side the artefact and the deliberation. Ask who would have looked lazy under document-only retention.
  6. Do not wait for the perfect join architecture before you emit commits. Capture first; version-level linking is the next problem, not a reason to keep throwing reasoning away.

Related published pieces for the neighbourhood this sits in: route-invariant grounding and the derivation-sensitive correction;1314 gold that addresses reality rather than containing it;5 the AI partner as challenger rather than arbiter.15 None of those re-argue this thesis. This one owns source-relativity for knowledge work, the least-useful-document inversion, the Knowledge Work Commit, the emission contract, the invisible-work and inherited-content proofs, and the Claude Code write/read commit loop as the public preview of Cognitive Git.

The deeper corporate opportunity is not capturing more documents. It is capturing the meaning-making process that produced them.

Keep the results. Keep the reasoning. The deliberation is source.

References

  1. Scott Farrell, LeverageAI. "The Prompt Is Source." — Stage-relative source: generated code is intermediate representation relative to the upstream package of intent, prompts, tests and decisions. https://leverageai.com.au/wp-content/media/articles/article.php?article=154-the-prompt-is-source (wiki chapter read: the-prompt-is-source-ebook ch1 #e5537a)
  2. Scott Farrell, LeverageAI. "The Prompt Is Source" (source maps). — Transcripts and prompts are source maps; code is the what, transcript often the why. (wiki chapter read: the-prompt-is-source-ebook ch8 #890597)
  3. Scott Farrell, LeverageAI. "Code What, Transcript Why." — Code records final state; transcript holds dated intent, rejected alternatives, and never-built plans. (wiki chapter read: code-what-transcript-why-ebook ch2 #5a7a03)
  4. Scott Farrell, LeverageAI. "Code What, Transcript Why." — The gap between transcript intent and shipped code is itself signal; repositories cannot generate “considered X, deferred.” (wiki chapter read: code-what-transcript-why-ebook ch7 #123e76)
  5. Scott Farrell, LeverageAI. "Gold Addresses Reality." — Gold needs to address reality, not contain it; worked near-present descent into bronze deliberation. https://leverageai.com.au/wp-content/media/articles/article.php?article=187-gold-addresses-reality (wiki chapters read: #11df87, #2f9a38)
  6. Scott Farrell, LeverageAI. "Keep the Bronze." — Do not discard raw archives; comprehension economics repriced retention. (wiki chapter read: keep-the-bronze-ebook ch1 #d8dfc2)
  7. Scott Farrell, LeverageAI. "Institutional Memory." — Episodic memory as staging buffer; governed wiki as consolidated record; promotion path between them. (wiki chapter read: institutional-memory-ebook ch3 #33437f)
  8. Scott Farrell, LeverageAI. "Code What, Transcript Why." — Deterministic strip then cheap-model session brief as durable searchable feeder. (wiki chapter read: code-what-transcript-why-ebook ch8 #24cffe)
  9. Scott Farrell, LeverageAI. "Keep the Bronze." — Deletion is the irreversible operation; keep bronze so later maps can be built. (wiki chapter read: keep-the-bronze-ebook ch1 #d8dfc2)
  10. Scott Farrell, LeverageAI. "Engagement World." — Missing mesoscale layer between transient chat and permanent institutional canon. (wiki chapter read: engagement-world-ebook ch2 #5613e7)
  11. Scott Farrell, LeverageAI. "Engagement World." — Multiple actors write one project world without perfect memory of every session. (wiki chapter read: engagement-world-ebook ch5 #db82f0)
  12. Scott Farrell, LeverageAI. "BI for Soft Data." — Soft layer is the causal layer; warehouses hold effects, not the why. (wiki chapter read: bi-for-soft-data-ebook ch2 #68d011)
  13. Scott Farrell, LeverageAI. "Route-Invariant Grounding." https://leverageai.com.au/wp-content/media/articles/article.php?article=182-route-invariant-grounding
  14. Scott Farrell, LeverageAI. "Derivational Provenance." https://leverageai.com.au/wp-content/media/articles/article.php?article=186-derivational-provenance
  15. Scott Farrell, LeverageAI. "Your AI Partner Is the Challenger." https://leverageai.com.au/wp-content/media/articles/article.php?article=188-your-ai-partner-is-the-challenger