# Concepts

Understand the static site, repository data, and agent interfaces.

## Static by design [#static-by-design]

Fumadocs MDX compiles source content into React pages. Next.js enumerates
documentation routes at build time. The host only serves files. Browser-side
project filters and Pagefind search do not need a server.

## Repository-led content [#repository-led-content]

`data/repositories.json` records the committed public repository capture;
`data/repository-audit.json` preserves the historical upstream audit.
The curated records in `data/projects/` select projects, categories, homepage
features, and editorial overrides. Build-time generation combines them with
repository facts to produce the project directory, documentation, and navigation.
A description sourced from the current snapshot carries its capture date; a
legacy attribution is identified separately. Descriptions state repository
scope, not verified maturity. See the [documentation policy](https://archont561.github.io/docs/development/documentation#project-data)
for the editing workflow.

`data/packages.json` supplies the package page. Builds do not call the GitHub
API or registries.

The intended live worker-client integration and snapshot fallback depend on
unfinished M2 and M3 work. The current site is snapshot-only.

## Human and agent access [#human-and-agent-access]

The same canonical sources produce HTML and portable Markdown. See
[AI access](https://archont561.github.io/docs/ai-access) for the generated indexes.