_   _  ___  _____ ____ ___ ____
  | \ | |/ _ \| ____|_  /|_ _/ ___|
  |  \| | | | |  _|  / /  | |\___ \
  | |\  | |_| | |___/ /_  | | ___) |
  |_| \_|\___/|_____/____|___|____/

  Noezis — documentation lisible par machine (format llmstxt.org).
  Cet index liste chaque page de doc avec un résumé et un lien.

  👋 Humain ?  La version lisible et illustrée est sur  →  /docs/
  🤖 Agent ?   Ce fichier est fait pour toi : ingère-le tel quel.
  ℹ️  Format :  https://llmstxt.org
────────────────────────────────────────────────────────────────────────────

# Noezis

> Noezis is an agent-first knowledge substrate: a governed, auditable knowledge graph navigated deterministically (no LLM in the search loop) that tells an agent what is known, contested, stale or missing — replacing static context to curb hallucination and environment blindness.

## Tutorials

- [Démarrer avec Noezis en 5 minutes](tutorial/getting-started.md): **Tutorial** — à la fin, Noezis sera branché sur votre repo, aura indexé un

## How-to guides

- [Vérifier que Noezis va bien](how-to/check-health.md): How-to — objectif : diagnostiquer en quelques secondes si Noezis sert bien le
- [Ingérer des documents et surveiller un dossier](how-to/ingest-and-watch.md): How-to — objectif : alimenter le graphe avec vos documents, ponctuellement ou en
- [Brancher Noezis sur un dépôt](how-to/onboard-a-repo.md): How-to — objectif : connecter Noezis à un dépôt en une commande, pour que votre
- [Choisir le bon mode de recherche](how-to/search-modes.md): How-to — objectif : savoir quand utiliser la recherche sémantique, lexicale ou
- [Tracer une décision](how-to/trace-a-decision.md): How-to — objectif : enregistrer une décision structurée dans le graphe pour que

## Reference

- [Reference — CLI (`noezis`)](reference/cli.md): 22 subcommands (git/kubectl-style). Version `0.2.0`. Flags are shown verbatim from `--help` (authoritative, never paraphrased).
- [Reference — MCP verbs](reference/mcp-verbs.md): 61 verbs exposed over JSON-RPC 2.0 (stdio). Each verb is callable by any MCP-capable agent. Grouped by capability tier.

## Explanation

- [Contradictions : une détection stable, sans spéculation](explanation/contradictions.md): Explanation — objectif : comprendre pourquoi Noezis détecte de façon fiable les
- [Le cycle de vie d'une information](explanation/knowledge-lifecycle.md): Explanation — objectif : comprendre pourquoi une information n'est pas un fichier figé
- [La proprioception de l'agent](explanation/proprioception.md): Explanation — la thèse de fond de Noezis : remplacer le contexte *statique* collé
- [Décision ≠ document](explanation/registre-vs-prose.md): Explanation — pourquoi Noezis traite une décision autrement qu'un document, et
- [Un index par sujet](explanation/the-knowledge-tree.md): Explanation — pourquoi Noezis range votre savoir par sujet plutôt qu'en simple
- [Pourquoi la recherche n'utilise pas de LLM](explanation/why-no-llm-in-search.md): Explanation — le choix de conception le plus structurant de Noezis, et ce qu'il