# Keeping Knowledge Current



<a id="section-flow"></a>

## The update loop

```mermaid
flowchart LR
  change["Source changes"] --> cmp["Compare versions"]
  cmp --> decide["Keep, revise, add"]
  decide --> write["Write"]
  write --> review["Review"]
  review --> deliver["Close and build"]
  deliver --> base["New baseline"]
```

Building completes the currently approved state; it does not freeze the Context knowledge workspace. When a source moves on, `context update` opens a new round for the selected change. The workflow hands the Agent the fixed old and new source versions and the confirmed requirement scope, plus a list of pages that cite the changed material.


<a id="section-decide"></a>

## Deciding what to change

The listed pages are candidates to inspect, not an instruction to rewrite all of them. For each page the Agent reads its current approved Markdown and the change, then submits one decision: no change, or a concrete correction. Unrelated content and readers' earlier improvements are preserved.

Existing references cannot discover every new topic, so the Agent also inspects additions and shared dependencies and lists necessary **new pages**, each with a path, title, registered sources and instruction. New pages go through the same writing and review as revisions. A renamed subject is revised in place rather than given a new identity; a retirement explains what disappeared and which readers are affected instead of silently deleting pages.


<a id="section-baseline"></a>

## Moving the baseline

The CLI keeps the previous processed version until every requested page has been approved, closed and built. If temporary progress is lost, the next inspection starts again from that version and keeps pages already approved. A saved report or acquisition receipt does not prove the update was completed. See [Version-Aware Knowledge](</context/llms/pages/18ad2071817e654c495d330acc898bf9.txt>).


<a id="section-scope"></a>

## Keep the update local

For one or two documents or a clearly bounded module, the update stays local: which articles to add or revise, and where readers expect them. It does not turn into a taxonomy for the whole knowledge workspace or a navigation redesign. Only the sources needed for the current change are restored; missing material stays a gap rather than being treated as investigated.


<a id="section-triggers"></a>

## Ways an update starts

| Trigger | How |
| --- | --- |
| A source changed | Tell `/c4a:context` the new version; it runs `context update` for the selected scope |
| A page is wrong or incomplete | `context revise "<page>" --instruction "<correction>"` continues through Review and delivery, with no recapture for wording-only changes |
| Unattended or scheduled runs | An authorized task can pass `CONTEXT_RUN_POLICY` with `plan_review` and `knowledge_review` set to `ask` or `delegate`; human-only Gates still stop |

Gaps found while answering questions are handled the same way: they become revision tasks for the affected pages.

---

## Sources

- [context/packages/context-cli/README.md L123–L124 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context-cli/README.md#L123-L124>)
- [context/packages/context-cli/context-workflow/resources/procedures/source-update.md L9–L16 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context-cli/context-workflow/resources/procedures/source-update.md#L9-L16>)
- [context/packages/context/docs/getting-started.md L155–L157 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context/docs/getting-started.md#L155-L157>)
- [context/packages/context-cli/context-workflow/resources/procedures/source-update.md L15–L27 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context-cli/context-workflow/resources/procedures/source-update.md#L15-L27>)
- [context/packages/context-cli/context-workflow/resources/procedures/source-update.md L41–L47 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context-cli/context-workflow/resources/procedures/source-update.md#L41-L47>)
- [context/packages/context-cli/context-workflow/resources/procedures/source-update.md L29–L32 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context-cli/context-workflow/resources/procedures/source-update.md#L29-L32>)
- [context/packages/context/docs/reference/indexer-provider-protocol.md L637–L639 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context/docs/reference/indexer-provider-protocol.md#L637-L639>)
- [context/packages/context/docs/guides/knowledge-updates.md L64–L69 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context/docs/guides/knowledge-updates.md#L64-L69>)
- [context/packages/context/docs/guides/knowledge-updates.md L52–L58 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context/docs/guides/knowledge-updates.md#L52-L58>)
- [context/packages/context/docs/guides/knowledge-updates.md L13–L17 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context/docs/guides/knowledge-updates.md#L13-L17>)
- [context/packages/context/docs/getting-started.md L9–L27 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context/docs/getting-started.md#L9-L27>)