# Packages and Sites



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

## One body of knowledge, several outputs

```mermaid
flowchart LR
  kn["Approved knowledge"] --> build["context build"]
  kmap["Knowledge map"] --> build
  tpl["Package templates"] --> build
  build --> kb["Knowledge package"]
  build --> site["Documentation site"]
  build --> llms["LLM Docs"]
  build --> inv["Build inventory"]
```

Build consumes only approved and closed knowledge. Output channels can be combined; for a new knowledge workspace the Agent proposes a knowledge package plus a website by default, and LLM text is an additional choice. Every build emits an inventory that maps distributed files back to approved knowledge in the knowledge workspace.


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

## Agent knowledge packages

A knowledge package uses flat roots:

| Root | Internal collections |
| --- | --- |
| `wikis/` | `codegraph`, `business`, `product` |
| `guides/` | `architecture`, `sop`, `faq`, `decision`, `incident` |
| `rules/` | `standards`, `test` |
| `feats/` | `feats` |

The default `knowledge-query` skill is the Agent-facing entry: it starts from directory indexes, follows edge records in the inventory, reads candidate pages and cites their headings, and reports gaps when the package does not cover a fact. When indexes do not narrow the scope, its bundled `scripts/search.mjs` ranks Markdown chunks locally. Consumer pages omit `sources` and section metadata; exact attribution stays in the workspace and is reached through the inventory.


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

## Documentation sites

Enabling `site` on a package also produces `dist/<base>-site/`: a static site with article pages, local search, scripts and styles, built in a sibling staging directory so a failed site build keeps the previous output.

- **Navigation** comes from the accepted `src/knowledge-map.yaml`. Entries bind to article identity, so labels and groups do not change URLs, and one article can appear in several places.
- **Homepage** uses the first-level knowledge map as a complete site map.
- **Diagrams** written in Mermaid render in the browser with the site theme and offer fit, zoom, full-screen and source controls.
- **Source footer** on each article links repositories at their recorded revision and documents at their registered URL.
- **Languages** can be added with `site.locales`; untranslated pages show the original with a notice.

Context does not deploy. Preview with any static HTTP server and deploy the contents of `dist/<base>-site/` with your own hosting.


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

## LLM Docs

`llmsPackage()` produces a text bundle for model context, offline evaluation or downstream ingestion:

```text
llms.txt                   # knowledge-map index
llms-full.txt              # consolidated approved text
llms/pages/<identity>.txt  # individual articles
```


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

## Customizing without forking the knowledge

Package templates shape distribution — extra Agent instructions, static files, query helpers — but never replace approved knowledge as the source of truth. Presentation sources for a site, such as homepage slots, custom pages and theme components, live under `src/site/`, separate from generated knowledge.

---

## Sources

- [context/packages/context/docs/guides/package-outputs.md L12–L16 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context/docs/guides/package-outputs.md#L12-L16>)
- [context/packages/context/docs/guides/package-outputs.md L33–L37 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context/docs/guides/package-outputs.md#L33-L37>)
- [context/README.md L106–L114 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/README.md#L106-L114>)
- [context/ARCHITECTURE.md L304–L317 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/ARCHITECTURE.md#L304-L317>)
- [context/packages/context/docs/guides/package-outputs.md L243–L255 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context/docs/guides/package-outputs.md#L243-L255>)
- [context/packages/context/docs/guides/package-outputs.md L45–L54 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context/docs/guides/package-outputs.md#L45-L54>)
- [context/packages/context/docs/guides/package-outputs.md L97–L133 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context/docs/guides/package-outputs.md#L97-L133>)
- [context/packages/context/docs/guides/package-outputs.md L174–L187 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context/docs/guides/package-outputs.md#L174-L187>)
- [context/packages/context/docs/guides/package-outputs.md L363–L376 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context/docs/guides/package-outputs.md#L363-L376>)
- [context/packages/context/docs/reference/package-templates.md L294–L300 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context/docs/reference/package-templates.md#L294-L300>)
- [context/packages/context/docs/guides/package-outputs.md L39–L43 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context/docs/guides/package-outputs.md#L39-L43>)