Best practice L2 · Context engineering informational

Prune Project Knowledge So It Stays Sharp

What it is

Treating a Claude Project's knowledge as something you maintain, not just accumulate: periodically removing outdated files, reconciling documents that now contradict each other, and cutting material that's no longer relevant — so the project keeps giving accurate context instead of stale context.

knowledge decays — tend itAdd knowledge overtimeIt ages, duplicates,conflictsPrune stale +contradictoryChats stay accurate
Stale and contradictory files quietly poison every chat in the project.

Why it works

Project knowledge feeds every chat in the project, which is its strength and its trap. Yesterday's price list, a superseded spec, an old brand guide sitting next to the new one — Claude has no way to know which is current, so it may cite the wrong one with full confidence, and the error is invisible because it looks like grounded, on-brand output. Contradiction is worse than absence: two conflicting files force Claude to guess. Pruning keeps the knowledge base a source of truth rather than a pile of half-true history, and it's the difference between context that helps and context that quietly misleads.

When to use it

On any long-lived project, on a light recurring cadence — whenever the underlying facts change (a new version, a rebrand, a policy update) and periodically regardless. Especially right after Claude cites something wrong: check whether a stale file is the cause.

When not to use it

Brand-new or short-lived projects with little accumulated knowledge — there's nothing to prune yet. And don't strip out genuinely useful reference material just to shrink the pile; the goal is currency and consistency, not minimalism.

Prompt

Here is the current knowledge in my Claude project: <list the files/documents and their dates or versions>. Help me audit it: which items are likely outdated, which pairs contradict each other, and which are redundant? For each, recommend keep / update / remove, and flag anything Claude might currently be citing that's no longer true.

Example

A product project still held last quarter's pricing doc alongside the new one. Claude quoted the old prices in a customer-facing draft — confidently, because the file was right there. Removing the superseded doc and keeping only the current one fixed it at the source; no amount of careful prompting would have, because the wrong 'truth' was in the knowledge base.

Advanced version

Version and date your knowledge files, and keep a short index doc at the top of the project listing what's current and what each file is for. Then reconciliation is a quick scan rather than an archaeology dig, and Claude has an explicit signal for which document supersedes which when two overlap.

Common mistakes

  • Only ever adding to project knowledge, never removing — until stale files outnumber current ones.
  • Leaving two contradictory documents in place and assuming Claude will pick the right one; it can't reliably.
  • Discovering the stale file only after Claude has already used it in something you sent out.

Related