# Notes



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

A note is Markdown you supply directly: an excerpt from a document Context cannot read, a summary of a decision, a field observation, a checklist from experience. Context saves it as a source under `sources/note/YYYYMMDD/topic.md`. There is no registry and no capture phase — the saved file *is* the evidence that pages cite.

Use a note when the material is text you already hold. Use a [session summary](</context/llms/pages/9ef52909ce6db4f3b229b8a7ea119525.txt>) when it comes from an Agent conversation, and a [document source](</context/llms/pages/8c2b49b432214167855ee9d7e2888616.txt>) or [Lark source](</context/llms/pages/fafe8d11c18d92f5a291f0d33365cebc.txt>) when Context can capture the original itself.


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

## Prepare the content

A note may hold original text, selected verbatim excerpts, a summary, or a mix. No fixed template is required, but when both originals and a summary are present, separate them with headings or prose, and label any summary as a summary rather than a transcript.

- Keep qualifications, exceptions, disagreements and open questions that affect the conclusion.
- State where the material came from and what was left out, when the omission matters.
- Quote only actual input; do not invent links, speakers, dates or confirmations.
- A link in a note does not mean its target was read.

Pages cite the note as saved, so leave out anything the eventual readers must not see before you save it.


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

## Save and select it

Ask the Agent in plain language:

```text
Save these release-process notes as a Context note, then use them for a
page on hotfix releases.
```

The Agent saves the body with `context source import`. Saving alone starts no knowledge work. To use the note in a production task, the Agent adds its typed reference to `src/index.ts`, keeping existing sources and phases:

```ts
source("20261012/release-process.md", { type: "note" });
```

A note that only supports an existing page does not need this: it joins that page's reading scope during a revision.


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

## How notes become knowledge

The Agent integrates what is useful into explanations, rules or steps for the reader; it does not copy the note wholesale or turn proposals into facts. A short exact passage is quoted only when its wording matters. Citations point at the stored note, never at an original the Agent could not read.


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

## Correcting a note

Two different problems, two different fixes:

| Problem | Fix |
| --- | --- |
| The note misrepresents the material | Correct the note itself through `source import`, passing its current `base_digest`. |
| The note is right but a page is misleading | Revise only that page and send it through Review. |

Approving knowledge never changes or removes the note. To rename one, `context source rename <ref> --name <name>` previews the change and then updates existing references safely.

---

## Sources

- [context/packages/context/docs/guides/note.md L19–L21 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context/docs/guides/note.md#L19-L21>)
- [context/packages/context/docs/getting-started.md L71–L74 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context/docs/getting-started.md#L71-L74>)
- [context/packages/context/docs/guides/note.md L6–L17 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context/docs/guides/note.md#L6-L17>)
- [context/packages/context/docs/guides/note.md L29–L30 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context/docs/guides/note.md#L29-L30>)
- [context/packages/context/docs/guides/note.md L19–L25 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context/docs/guides/note.md#L19-L25>)
- [context/packages/context-cli/context-workflow/resources/procedures/source-boundary.md L49–L59 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context-cli/context-workflow/resources/procedures/source-boundary.md#L49-L59>)
- [context/packages/context/docs/guides/note.md L27–L30 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context/docs/guides/note.md#L27-L30>)
- [context/packages/context/docs/guides/note.md L32–L37 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context/docs/guides/note.md#L32-L37>)
- [context/packages/context-cli/README.md L331–L332 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context-cli/README.md#L331-L332>)