# Documentation

- [What is Handbooks?](/docs): One codebase in, two handbooks out — a narrated documentation site your team reads, and a location index your coding agent routes with. Built from the same parsed map, kept current as the code moves.

- **Getting started**
- Getting started
  - [Installation](/docs/getting-started/installation): Node 20.11 and pnpm are the whole list. No native compilation, no Python, no node-gyp — the parsers are WebAssembly.
  - [Quick start](/docs/getting-started/quickstart): Run the entire toolchain end to end in about thirty seconds — offline, with no API key and zero tokens spent.
  - [Your first real handbook](/docs/getting-started/first-handbook): Eight steps from a repository you have never read to a change plan you can apply — with the cheap checkpoints in the right places.
  - [The vocabulary](/docs/getting-started/vocabulary): Stage, card, register, work dir, case, skill, plan — every word this project uses in a specific sense, defined once.

- **Understanding it**
- Concepts
  - [Why this exists](/docs/concepts/why): Summarizing a codebase does not help an agent find things. Routing does. This is the argument, and the design that follows from it.
  - [Architecture](/docs/concepts/architecture): Eleven packages in four layers, a strictly one-way dependency direction, and the boundaries that make the deterministic half reusable on its own.
  - [The five phases](/docs/concepts/pipeline): What each generation phase does, what it costs, what it degrades to when it fails, and how to re-run just one of them.
  - [The work directory](/docs/concepts/work-directory): Every artifact the pipeline produces, where it lives, what validates it, and what is safe to delete.
  - [Analysis fidelity](/docs/concepts/analysis-fidelity): Two analysis tiers produce identical-looking output. That is a trap, so every adapter declares what it can deliver and the handbook discloses it.
  - [What you can trust](/docs/concepts/trust-model): Which parts of a handbook are parsed facts, which are model output, what leaves your machine, and what the tool refuses to do.

- **Doing things**
- Guides
  - [Generating a handbook](/docs/guides/generating): Choosing detail, synthesis mode and strategy; running phases separately; resuming; and what to do when the result is wrong.
  - [Rendering outputs](/docs/guides/rendering): Markdown, an HTML site, one self-contained page, the agent index and llms.txt — all deterministic, all free to re-run.
  - [Packaging for your agent](/docs/guides/agent-skill): Turn a rendered handbook into a SKILL package with drift detection, and wire it into a coding agent.
  - [Planning a change](/docs/guides/planning-changes): Give the planner a request and a handbook; get back a byte-exact edit plan and a machine-readable declaration of what it touches.
  - [Applying and rolling back](/docs/guides/applying-changes): A mechanical executor with four safety rules, a backup that can prove what it restores, and a parser that refuses anything ambiguous.
  - [Keeping it current](/docs/guides/keeping-current): Resync diffs the old call graph against the new one and regenerates only what actually changed. Touch three files, pay for three files.
  - [Studio — the web UI](/docs/guides/studio): The whole toolchain in a browser tab, with live logs and one-click rollback. Localhost only, by design.
  - [Configuring Handbooks](/docs/guides/configuration): Five precedence layers, one registry, and a command that tells you exactly which layer won.
  - [Docker](/docs/guides/docker): Run the whole toolchain with no local Node install — including Studio, and one image across every environment.
  - [CI integration](/docs/guides/ci): Which commands are free enough to run on every commit, which need a key, and how to fail a build on handbook drift.
  - [Cost and performance](/docs/guides/cost-and-performance): Where the tokens actually go, which knobs move the needle, and how to find out before you spend anything.
  - [Troubleshooting](/docs/guides/troubleshooting): The things that actually go wrong, what the message means, and what to do about it.

- **Reference**
- Reference
  - [CLI reference](/docs/reference/cli): Every subcommand, every flag, its environment variable and its default — plus what each command writes and what it exits with.
  - [Configuration reference](/docs/reference/configuration): Every Handbooks setting, with its flag, environment variable, config-file key, type and default — generated from the registry.
  - [Environment variables](/docs/reference/environment): Every variable Handbooks reads, the naming rule that generates them, the .env cascade, and which ones must never enter a config file.
  - [Artifact formats](/docs/reference/artifacts): Every file the pipeline writes, its schema, and what validates it on read.
  - [Language support](/docs/reference/languages): 18 languages across two analysis tiers — which extensions each claims, what the generic tier gives up, and the two caveats worth knowing before you hit them.
  - [Prompt catalogue](/docs/reference/prompts): Every prompt the toolchain sends, what it asks for, and how each one degrades when the reply is unusable.
  - [Package index](/docs/reference/packages): Eleven npm packages, what each one exports, and which of them work with no LLM at all.
  - [Exit codes and output](/docs/reference/exit-codes): What each exit code means, what goes to stdout versus stderr, and how to script against both.

- **Contributing**
- Contributing
  - [Development](/docs/contributing/development): The build, the gates, the conventions the tooling enforces, and why the tests never need an API key.
  - [Adding a language](/docs/contributing/adding-a-language): A generic-tier language is a declarative spec, not a parser. A full-tier one is a small interface. Both need no new dependency.
  - [Releasing](/docs/contributing/releasing): Changesets drive versions and changelogs. Publishing stays inert until a token is configured, so the bookkeeping is correct either way.

# 文档

- [Handbooks 是什么？](/zh/docs): 一个代码库进来，两本手册出去——一份给团队读的叙述式文档站，一份给编码 agent 路由用的位置索引。同一张解析出的地图，随代码演进保持同步。

- **Getting started**
- 入门
  - [安装](/zh/docs/getting-started/installation): Node 20.11 和 pnpm，清单就这么长。没有原生编译、没有 Python、没有 node-gyp——解析器都是 WebAssembly。
  - [快速上手](/zh/docs/getting-started/quickstart): 大约三十秒内端到端跑完整条工具链——离线、无需 API key、零 token 消耗。
  - [你的第一本真实手册](/zh/docs/getting-started/first-handbook): 从一个你从没读过的仓库，到一份可以直接应用的改动计划，一共八步——并把便宜的检查点放在正确的位置上。
  - [词汇表](/zh/docs/getting-started/vocabulary): 阶段、卡片、寄存器、工作目录、case、skill、plan——本项目里每一个有特定含义的词，一次讲清楚。

- **Understanding it**
- 核心概念
  - [为什么要有这个项目](/zh/docs/concepts/why): 摘要一个代码库并不能帮代理找到东西，路由才能。这里是完整的论证，以及由此推出的设计。
  - [架构](/zh/docs/concepts/architecture): 四层十一个包、严格单向的依赖方向，以及让确定性的那一半可以单独复用的边界。
  - [五个阶段](/zh/docs/concepts/pipeline): 每个生成阶段做什么、花多少钱、失败时降级成什么，以及如何只重跑其中一个。
  - [工作目录](/zh/docs/concepts/work-directory): 流水线产出的每一个工件、它存放在哪里、由什么校验，以及删除哪些是安全的。
  - [分析保真度](/zh/docs/concepts/analysis-fidelity): 两个分析层级产出的东西看起来一模一样。这是个陷阱，所以每个适配器都要声明自己能交付什么，手册也会如实披露。
  - [哪些内容可以信任](/zh/docs/concepts/trust-model): 手册中哪些部分是解析得到的事实，哪些是模型输出，哪些数据会离开你的机器，以及这个工具拒绝做哪些事。

- **Doing things**
- 指南
  - [生成手册](/zh/docs/guides/generating): 如何选择详略程度、综合模式与策略；分阶段运行；断点续跑；以及结果不对时该怎么办。
  - [渲染输出](/zh/docs/guides/rendering): Markdown、HTML 站点、单个自包含页面、面向智能体的定位索引，以及 llms.txt——全部确定性，重跑零成本。
  - [打包给你的智能体](/zh/docs/guides/agent-skill): 把渲染好的手册变成带漂移检测的 SKILL 包，并接入编码智能体。
  - [规划一次修改](/zh/docs/guides/planning-changes): 把请求和手册交给规划器，拿回一份字节级精确的编辑计划，以及一份机器可读的影响声明。
  - [应用与回滚](/zh/docs/guides/applying-changes): 一个带四条安全规则的机械执行器、一份能证明自己在恢复什么的备份，以及一个拒绝一切歧义的解析器。
  - [让手册保持最新](/zh/docs/guides/keeping-current): Resync 把旧调用图与新调用图做差异对比，只重新生成真正变化的部分。改三个文件，就只为三个文件付费。
  - [Studio——Web 界面](/zh/docs/guides/studio): 整个工具链装进一个浏览器标签页，带实时日志和一键回滚。只限 localhost，设计使然。
  - [配置 Handbooks](/zh/docs/guides/configuration): 五个优先级层次、一张注册表，外加一条能确切告诉你哪一层生效了的命令。
  - [Docker](/zh/docs/guides/docker): 不装本地 Node 也能跑整个工具链——包括 Studio，并且一个镜像通吃所有环境。
  - [CI 集成](/zh/docs/guides/ci): 哪些命令便宜到可以每次提交都跑、哪些需要密钥，以及如何在手册漂移时让构建失败。
  - [成本与性能](/zh/docs/guides/cost-and-performance): token 到底花在了哪里、哪些旋钮真正管用，以及如何在花钱之前就先弄清楚。
  - [疑难排查](/zh/docs/guides/troubleshooting): 实际会出问题的那些事、报错是什么意思，以及该拿它怎么办。

- **Reference**
- 参考
  - [CLI 参考](/zh/docs/reference/cli): 每个子命令、每个参数、它的环境变量和默认值——以及每个命令写出什么、以什么退出码结束。
  - [配置参考](/zh/docs/reference/configuration): Handbooks 的每一项设置，连同它的命令行参数、环境变量、配置文件键、类型与默认值——由注册表生成。
  - [环境变量](/zh/docs/reference/environment): Handbooks 读取的每一个变量、生成它们的命名规则、.env 级联，以及哪些绝不能进入配置文件。
  - [产物格式](/zh/docs/reference/artifacts): 流水线写出的每一个文件、它们的 schema，以及读取时对其进行校验的东西。
  - [语言支持](/zh/docs/reference/languages): 18 种语言，横跨两个分析层级——各层级分别认领哪些扩展名、generic 层级放弃了什么，以及在你撞上之前值得先知道的两个注意事项。
  - [提示词目录](/zh/docs/reference/prompts): 工具链发出的每一条提示词、它各自要什么，以及当回复不可用时它们分别如何降级。
  - [包索引](/zh/docs/reference/packages): 十一个 npm 包、每个包导出什么，以及其中哪些完全不需要 LLM。
  - [退出码与输出](/zh/docs/reference/exit-codes): 每个退出码的含义、哪些内容走 stdout 哪些走 stderr，以及如何针对两者编写脚本。

- **Contributing**
- 参与贡献
  - [开发](/zh/docs/contributing/development): 构建、门禁、工具链强制执行的约定，以及测试为何从不需要 API key。
  - [添加一门语言](/zh/docs/contributing/adding-a-language): generic 层的语言是一份声明式规格，而不是一个解析器。full 层的语言则是一个小接口。两者都不需要新增依赖。
  - [发布](/zh/docs/contributing/releasing): changesets 驱动版本号和变更日志。在配置好 token 之前发布始终是空操作，所以无论如何账目都是对的。

# दस्तावेज़ीकरण

- [Handbooks क्या है?](/hi/docs): एक कोडबेस अंदर, दो handbooks बाहर — एक narrated documentation site जो आपकी टीम पढ़ती है, और एक location index जिससे आपका coding agent route करता है। एक ही parsed नक्शे से, कोड के साथ हमेशा अद्यतन।

- **Getting started**
- शुरुआत करें
  - [इंस्टॉलेशन](/hi/docs/getting-started/installation): Node 20.11 और pnpm — पूरी सूची बस इतनी है। कोई native compilation नहीं, कोई Python नहीं, कोई node-gyp नहीं — parsers WebAssembly हैं।
  - [त्वरित शुरुआत](/hi/docs/getting-started/quickstart): पूरी toolchain को शुरू से आख़िर तक लगभग तीस सेकंड में चलाइए — offline, बिना API key और शून्य tokens खर्च करके।
  - [आपका पहला असली handbook](/hi/docs/getting-started/first-handbook): एक कभी न पढ़ी repository से apply करने लायक़ change plan तक के आठ क़दम — सस्ते checkpoints सही जगहों पर रखते हुए।
  - [शब्दावली](/hi/docs/getting-started/vocabulary): Stage, card, register, work dir, case, skill, plan — हर वह शब्द जिसे यह project एक ख़ास अर्थ में बरतता है, एक ही जगह परिभाषित।

- **Understanding it**
- अवधारणाएँ
  - [यह क्यों मौजूद है](/hi/docs/concepts/why): Codebase की summary बनाने से agent को चीज़ें ढूँढने में मदद नहीं मिलती। Routing से मिलती है। यही दलील है, और उससे निकलने वाला design।
  - [आर्किटेक्चर](/hi/docs/concepts/architecture): चार layers में ग्यारह packages, सख़्ती से एकतरफ़ा dependency दिशा, और वे boundaries जो deterministic आधे हिस्से को अकेले भी reusable बनाती हैं।
  - [पाँच phases](/hi/docs/concepts/pipeline): हर generation phase क्या बनाता है, उसकी क्या लागत है, fail होने पर वह किसमें degrade होता है, और उनमें से सिर्फ़ एक को दोबारा कैसे चलाएँ।
  - [वर्क डायरेक्टरी](/hi/docs/concepts/work-directory): Pipeline जो भी artifact बनाती है — वह कहाँ रहता है, उसे कौन validate करता है, और क्या delete करना सुरक्षित है।
  - [विश्लेषण की सटीकता](/hi/docs/concepts/analysis-fidelity): दो analysis tiers एक जैसा दिखने वाला output बनाते हैं। यह एक जाल है, इसलिए हर adapter घोषित करता है कि वह क्या दे सकता है, और handbook उसे disclose करता है।
  - [आप किस पर भरोसा कर सकते हैं](/hi/docs/concepts/trust-model): Handbooks के कौन से हिस्से parsed facts हैं, कौन से model का output, आपकी मशीन से क्या बाहर जाता है, और यह tool क्या करने से मना कर देता है।

- **Doing things**
- गाइड
  - [Handbooks जनरेट करना](/hi/docs/guides/generating): Detail, synthesis mode और strategy चुनना; phases को अलग-अलग चलाना; resume करना; और परिणाम गलत होने पर क्या करें।
  - [आउटपुट रेंडर करना](/hi/docs/guides/rendering): Markdown, एक HTML साइट, एक स्वयं-निहित पृष्ठ, agent locator index और llms.txt — सब नियतात्मक, सब दोबारा चलाने के लिए मुफ़्त।
  - [अपने एजेंट के लिए पैकेजिंग](/hi/docs/guides/agent-skill): render किए गए handbook को drift detection के साथ एक SKILL पैकेज में बदलें, और उसे किसी coding एजेंट से जोड़ें।
  - [बदलाव का plan बनाना](/hi/docs/guides/planning-changes): planner को एक request और एक handbook दें; बदले में byte-exact edit plan और वह क्या-क्या छूता है इसकी machine-readable घोषणा पाएँ।
  - [Apply करना और rollback करना](/hi/docs/guides/applying-changes): चार सुरक्षा नियमों वाला एक यांत्रिक निष्पादक, ऐसा backup जो साबित कर सकता है कि वह क्या बहाल करता है, और ऐसा parser जो हर अस्पष्ट चीज़ को अस्वीकार कर देता है।
  - [इसे अप-टू-डेट रखना](/hi/docs/guides/keeping-current): Resync पुराने call graph की तुलना नए से करता है और केवल वही regenerate करता है जो वास्तव में बदला है। तीन फ़ाइलें छुएँ, तीन फ़ाइलों की ही क़ीमत चुकाएँ।
  - [Studio — वेब UI](/hi/docs/guides/studio): पूरा toolchain एक ब्राउज़र टैब में, लाइव logs और one-click rollback के साथ। जानबूझकर केवल localhost।
  - [Handbooks को कॉन्फ़िगर करना](/hi/docs/guides/configuration): पाँच precedence परतें, एक registry, और एक कमांड जो आपको ठीक-ठीक बताता है कि कौन-सी परत जीती।
  - [Docker](/hi/docs/guides/docker): बिना किसी local Node इंस्टॉल के पूरा toolchain चलाएँ — Studio सहित, और हर environment में एक ही image।
  - [CI एकीकरण](/hi/docs/guides/ci): कौन-से कमांड इतने मुफ़्त हैं कि हर commit पर चलें, किन्हें key चाहिए, और handbook drift पर build को कैसे fail करें।
  - [लागत और प्रदर्शन](/hi/docs/guides/cost-and-performance): टोकन असल में कहाँ जाते हैं, कौन-से knobs वाक़ई फ़र्क डालते हैं, और कुछ भी खर्च करने से पहले यह कैसे पता करें।
  - [समस्या-निवारण](/hi/docs/guides/troubleshooting): जो चीज़ें वाक़ई ग़लत होती हैं, संदेश का क्या मतलब है, और उसके बारे में क्या किया जाए।

- **Reference**
- संदर्भ
  - [CLI संदर्भ](/hi/docs/reference/cli): हर subcommand, हर flag, उसका environment variable और उसका डिफ़ॉल्ट — साथ ही यह भी कि हर कमांड क्या लिखती है और किस exit code के साथ खत्म होती है।
  - [Configuration संदर्भ](/hi/docs/reference/configuration): Handbooks की हर setting, उसके flag, environment variable, config-फ़ाइल key, प्रकार और डिफ़ॉल्ट के साथ — registry से जनरेट की गई।
  - [एनवायरनमेंट वेरिएबल्स](/hi/docs/reference/environment): Handbooks जो भी variable पढ़ता है, उन्हें बनाने वाला नामकरण नियम, .env cascade, और वे जिन्हें कभी config फ़ाइल में नहीं जाना चाहिए।
  - [Artifact प्रारूप](/hi/docs/reference/artifacts): pipeline जो भी फ़ाइल लिखती है, उसका schema, और पढ़ते समय उसे कौन सत्यापित करता है।
  - [भाषा समर्थन](/hi/docs/reference/languages): दो analysis स्तरों में 18 भाषाएँ — कौन-सी भाषा कौन-से extensions लेती है, generic स्तर क्या छोड़ देता है, और टकराने से पहले जानने लायक दो चेतावनियाँ।
  - [Prompt सूची](/hi/docs/reference/prompts): toolchain जो भी prompt भेजती है, वह क्या माँगता है, और उत्तर बेकार निकलने पर हर एक कैसे घटता है।
  - [पैकेज सूचकांक](/hi/docs/reference/packages): ग्यारह npm पैकेज, हर एक क्या export करता है, और इनमें से कौन बिना किसी LLM के काम करते हैं।
  - [Exit codes और आउटपुट](/hi/docs/reference/exit-codes): हर exit code का क्या मतलब है, stdout बनाम stderr पर क्या जाता है, और दोनों के लिए स्क्रिप्ट कैसे लिखें।

- **Contributing**
- योगदान
  - [विकास](/hi/docs/contributing/development): Build, gates, वे परंपराएँ जिन्हें औज़ार लागू करते हैं, और क्यों tests को कभी API key की ज़रूरत नहीं पड़ती।
  - [एक भाषा जोड़ना](/hi/docs/contributing/adding-a-language): Generic स्तर की भाषा एक घोषणात्मक spec है, parser नहीं। पूर्ण स्तर की भाषा एक छोटा interface है। दोनों को कोई नई निर्भरता नहीं चाहिए।
  - [Release करना](/hi/docs/contributing/releasing): Changesets संस्करण और changelogs चलाते हैं। जब तक token कॉन्फ़िगर न हो प्रकाशन निष्क्रिय रहता है, इसलिए हिसाब-किताब दोनों ही हाल में सही रहता है।

# Documentación

- [¿Qué es Handbooks?](/es/docs): Un código base entra, dos manuales salen — un sitio de documentación narrado que tu equipo lee y un índice de ubicaciones con el que tu agente de código se orienta. Del mismo mapa parseado, siempre al día con el código.

- **Getting started**
- Primeros pasos
  - [Instalación](/es/docs/getting-started/installation): Node 20.11 y pnpm: esa es toda la lista. Sin compilación nativa, sin Python, sin node-gyp — los parsers son WebAssembly.
  - [Inicio rápido](/es/docs/getting-started/quickstart): Ejecuta la cadena de herramientas completa de principio a fin en unos treinta segundos — sin conexión, sin clave de API y sin gastar un solo token.
  - [Tu primer handbook real](/es/docs/getting-started/first-handbook): Ocho pasos desde un repositorio que nunca has leído hasta un plan de cambios que puedes aplicar — con los checkpoints baratos en el lugar correcto.
  - [El vocabulario](/es/docs/getting-started/vocabulary): Etapa, ficha, registro, directorio de trabajo, caso, skill, plan — cada palabra que este proyecto usa en un sentido específico, definida una sola vez.

- **Understanding it**
- Conceptos
  - [Por qué existe esto](/es/docs/concepts/why): Resumir una base de código no ayuda a un agente a encontrar cosas. Enrutar sí. Este es el argumento, y el diseño que se sigue de él.
  - [Arquitectura](/es/docs/concepts/architecture): Once paquetes en cuatro capas, una dirección de dependencias estrictamente unidireccional y las fronteras que hacen reutilizable por sí sola la mitad determinista.
  - [Las cinco fases](/es/docs/concepts/pipeline): Qué hace cada fase de generación, qué cuesta, a qué se degrada cuando falla y cómo re-ejecutar solo una de ellas.
  - [El directorio de trabajo](/es/docs/concepts/work-directory): Cada artefacto que produce el pipeline, dónde vive, qué lo valida y qué es seguro borrar.
  - [Fidelidad del análisis](/es/docs/concepts/analysis-fidelity): Dos niveles de análisis producen una salida de aspecto idéntico. Eso es una trampa, así que cada adaptador declara lo que puede ofrecer y el handbook lo divulga.
  - [En qué puedes confiar](/es/docs/concepts/trust-model): Qué partes de un handbook son hechos parseados, cuáles son salida del modelo, qué sale de tu máquina y qué se niega a hacer la herramienta.

- **Doing things**
- Guías
  - [Generar un handbook](/es/docs/guides/generating): Elegir el detalle, el modo de síntesis y la estrategia; ejecutar fases por separado; reanudar; y qué hacer cuando el resultado es incorrecto.
  - [Renderizar las salidas](/es/docs/guides/rendering): Markdown, un sitio HTML, una página autocontenida, el índice localizador para agentes y llms.txt — todo determinista, todo gratis de re-ejecutar.
  - [Empaquetado para tu agente](/es/docs/guides/agent-skill): Convierte un handbook renderizado en un paquete SKILL con detección de deriva, y conéctalo a un agente de código.
  - [Planificar un cambio](/es/docs/guides/planning-changes): Dale al planificador una petición y un handbook; recibe a cambio un plan de edición byte-exacto y una declaración legible por máquina de lo que toca.
  - [Aplicar y hacer rollback](/es/docs/guides/applying-changes): Un ejecutor mecánico con cuatro reglas de seguridad, una copia de seguridad que puede probar lo que restaura y un parser que rechaza cualquier ambigüedad.
  - [Mantenerlo al día](/es/docs/guides/keeping-current): Resync compara el grafo de llamadas antiguo con el nuevo y regenera solo lo que realmente cambió. Tocas tres archivos, pagas por tres archivos.
  - [Studio — la interfaz web](/es/docs/guides/studio): Toda la cadena de herramientas en una pestaña del navegador, con logs en vivo y rollback con un clic. Solo localhost, por diseño.
  - [Configurar Handbooks](/es/docs/guides/configuration): Cinco capas de precedencia, un registro y un comando que te dice exactamente qué capa ganó.
  - [Docker](/es/docs/guides/docker): Ejecuta toda la cadena de herramientas sin una instalación local de Node — incluido Studio, y una sola imagen para todos los entornos.
  - [Integración con CI](/es/docs/guides/ci): Qué comandos son lo bastante gratuitos para ejecutarse en cada commit, cuáles necesitan una clave y cómo hacer fallar un build ante la deriva del handbook.
  - [Coste y rendimiento](/es/docs/guides/cost-and-performance): Adónde van realmente los tokens, qué controles mueven la aguja y cómo averiguarlo antes de gastar nada.
  - [Solución de problemas](/es/docs/guides/troubleshooting): Lo que de verdad sale mal, qué significa el mensaje y qué hacer al respecto.

- **Reference**
- Referencia
  - [Referencia de la CLI](/es/docs/reference/cli): Cada subcomando, cada flag, su variable de entorno y su valor por defecto — además de qué escribe cada comando y con qué código de salida termina.
  - [Referencia de configuración](/es/docs/reference/configuration): Todos los ajustes de Handbooks, con su flag, variable de entorno, clave del archivo de configuración, tipo y valor por defecto — generado a partir del registro.
  - [Variables de entorno](/es/docs/reference/environment): Todas las variables que Handbooks lee, la regla de nombres que las genera, la cascada de .env y cuáles no deben entrar nunca en un archivo de configuración.
  - [Formatos de los artefactos](/es/docs/reference/artifacts): Cada archivo que escribe el pipeline, su esquema y qué lo valida al leerlo.
  - [Soporte de lenguajes](/es/docs/reference/languages): 18 lenguajes repartidos en dos niveles de análisis — qué extensiones reclama cada uno, a qué renuncia el nivel generic y las dos salvedades que conviene conocer antes de toparte con ellas.
  - [Catálogo de prompts](/es/docs/reference/prompts): Cada prompt que envía la cadena de herramientas, qué pide y cómo se degrada cada uno cuando la respuesta es inservible.
  - [Índice de paquetes](/es/docs/reference/packages): Once paquetes npm, qué exporta cada uno y cuáles funcionan sin ningún LLM.
  - [Códigos de salida y salida por consola](/es/docs/reference/exit-codes): Qué significa cada código de salida, qué va a stdout frente a stderr y cómo escribir scripts contra ambos.

- **Contributing**
- Contribuir
  - [Desarrollo](/es/docs/contributing/development): La compilación, los controles, las convenciones que impone el tooling y por qué las pruebas nunca necesitan una clave de API.
  - [Añadir un lenguaje](/es/docs/contributing/adding-a-language): Un lenguaje de nivel genérico es una especificación declarativa, no un parser. Uno de nivel completo es una interfaz pequeña. Ninguno de los dos necesita una nueva dependencia.
  - [Publicar versiones](/es/docs/contributing/releasing): Los changesets gobiernan las versiones y los changelogs. La publicación permanece inerte hasta que se configura un token, así que la contabilidad es correcta en cualquier caso.

# Documentação

- [O que é o Handbooks?](/pt/docs): Um código-fonte entra, dois manuais saem — um site de documentação narrado que o seu time lê e um índice de localização com que o seu agente de código se orienta. Do mesmo mapa parseado, sempre em dia com o código.

- **Getting started**
- Primeiros passos
  - [Instalação](/pt/docs/getting-started/installation): Node 20.11 e pnpm são a lista inteira. Sem compilação nativa, sem Python, sem node-gyp — os parsers são WebAssembly.
  - [Guia rápido](/pt/docs/getting-started/quickstart): Execute a cadeia de ferramentas inteira, de ponta a ponta, em cerca de trinta segundos — offline, sem chave de API e sem gastar tokens.
  - [Seu primeiro handbook de verdade](/pt/docs/getting-started/first-handbook): Oito passos entre um repositório que você nunca leu e um plano de mudança aplicável — com os checkpoints baratos nos lugares certos.
  - [O vocabulário](/pt/docs/getting-started/vocabulary): Etapa, ficha, registrador, diretório de trabalho, caso, skill, plano — cada palavra que este projeto usa em um sentido específico, definida uma única vez.

- **Understanding it**
- Conceitos
  - [Por que isto existe](/pt/docs/concepts/why): Resumir uma base de código não ajuda um agente a encontrar as coisas. Roteamento ajuda. Este é o argumento, e o design que decorre dele.
  - [Arquitetura](/pt/docs/concepts/architecture): Onze pacotes em quatro camadas, uma direção de dependência estritamente unidirecional e as fronteiras que tornam a metade determinística reutilizável por conta própria.
  - [As cinco fases](/pt/docs/concepts/pipeline): O que cada fase de geração faz, quanto ela custa, para o que degrada quando falha e como reexecutar só uma delas.
  - [O diretório de trabalho](/pt/docs/concepts/work-directory): Cada artefato que o pipeline produz, onde ele vive, o que o valida e o que é seguro apagar.
  - [Fidelidade da análise](/pt/docs/concepts/analysis-fidelity): Dois níveis de análise produzem saídas de aparência idêntica. Isso é uma armadilha, então cada adaptador declara o que consegue entregar e o handbook divulga isso.
  - [Em que você pode confiar](/pt/docs/concepts/trust-model): Quais partes de um handbook são fatos do parser, quais são saída de modelo, o que sai da sua máquina e o que a ferramenta se recusa a fazer.

- **Doing things**
- Guias
  - [Gerando um handbook](/pt/docs/guides/generating): Escolhendo detalhe, modo de síntese e estratégia; executando fases separadamente; retomando; e o que fazer quando o resultado está errado.
  - [Renderizando as saídas](/pt/docs/guides/rendering): Markdown, um site HTML, uma página autocontida, o índice localizador para agentes e llms.txt — tudo determinístico, tudo gratuito de reexecutar.
  - [Empacotando para o seu agente](/pt/docs/guides/agent-skill): Transforme um handbook renderizado em um pacote SKILL com detecção de deriva e conecte-o a um agente de codificação.
  - [Planejando uma mudança](/pt/docs/guides/planning-changes): Dê ao planejador um pedido e um handbook; receba de volta um plano de edição exato em bytes e uma declaração legível por máquina do que ele toca.
  - [Aplicando e fazendo rollback](/pt/docs/guides/applying-changes): Um executor mecânico com quatro regras de segurança, um backup que pode provar o que restaura e um parser que recusa qualquer coisa ambígua.
  - [Mantendo-o atualizado](/pt/docs/guides/keeping-current): O resync compara o grafo de chamadas antigo com o novo e regenera apenas o que realmente mudou. Toque em três arquivos, pague por três arquivos.
  - [Studio — a interface web](/pt/docs/guides/studio): Toda a toolchain em uma aba do navegador, com logs ao vivo e rollback em um clique. Somente localhost, por design.
  - [Configurando o Handbooks](/pt/docs/guides/configuration): Cinco camadas de precedência, um registro e um comando que diz exatamente qual camada venceu.
  - [Docker](/pt/docs/guides/docker): Rode toda a toolchain sem nenhuma instalação local de Node — incluindo o Studio, e com uma única imagem para todos os ambientes.
  - [Integração com CI](/pt/docs/guides/ci): Quais comandos são baratos o bastante para rodar a cada commit, quais precisam de uma chave e como quebrar o build quando o handbook entra em deriva.
  - [Custo e desempenho](/pt/docs/guides/cost-and-performance): Para onde os tokens realmente vão, quais botões movem o ponteiro e como descobrir isso antes de gastar qualquer coisa.
  - [Solução de problemas](/pt/docs/guides/troubleshooting): As coisas que de fato dão errado, o que a mensagem significa e o que fazer a respeito.

- **Reference**
- Referência
  - [Referência da CLI](/pt/docs/reference/cli): Cada subcomando, cada flag, sua variável de ambiente e seu padrão — além do que cada comando escreve e com o que ele sai.
  - [Referência de configuração](/pt/docs/reference/configuration): Cada configuração do Handbooks, com sua flag, variável de ambiente, chave de arquivo de configuração, tipo e padrão — gerada a partir do registro.
  - [Variáveis de ambiente](/pt/docs/reference/environment): Cada variável que o Handbooks lê, a regra de nomenclatura que as gera, a cascata de .env e quais delas jamais podem entrar em um arquivo de configuração.
  - [Formatos de artefato](/pt/docs/reference/artifacts): Todo arquivo que o pipeline escreve, seu schema e o que o valida na leitura.
  - [Suporte a linguagens](/pt/docs/reference/languages): 18 linguagens em dois níveis de análise — quais extensões cada uma reivindica, do que o nível generic abre mão e as duas ressalvas que vale conhecer antes de esbarrar nelas.
  - [Catálogo de prompts](/pt/docs/reference/prompts): Todo prompt que a toolchain envia, o que ele pede e como cada um degrada quando a resposta é inutilizável.
  - [Índice de pacotes](/pt/docs/reference/packages): Onze pacotes npm, o que cada um exporta e quais deles funcionam sem nenhum LLM.
  - [Códigos de saída e output](/pt/docs/reference/exit-codes): O que cada código de saída significa, o que vai para stdout e o que vai para stderr, e como escrever scripts contra os dois.

- **Contributing**
- Contribuindo
  - [Desenvolvimento](/pt/docs/contributing/development): A build, os gates, as convenções que a tooling impõe e por que os testes nunca precisam de uma chave de API.
  - [Adicionando uma linguagem](/pt/docs/contributing/adding-a-language): Uma linguagem de nível generic é uma especificação declarativa, não um parser. Uma de nível full é uma interface pequena. Nenhuma das duas precisa de uma nova dependência.
  - [Publicando versões](/pt/docs/contributing/releasing): Os changesets conduzem as versões e os changelogs. A publicação permanece inerte até que um token seja configurado, então a contabilidade fica correta de qualquer forma.

# Документация

- [Что такое Handbooks?](/ru/docs): Один код на входе, два справочника на выходе — повествовательный сайт документации для команды и индекс местоположений для кодинг-агента. Из одной распарсенной карты, всегда в ногу с кодом.

- **Getting started**
- Начало работы
  - [Установка](/ru/docs/getting-started/installation): Node 20.11 и pnpm — вот и весь список. Никакой нативной компиляции, никакого Python, никакого node-gyp — парсеры представляют собой WebAssembly.
  - [Быстрый старт](/ru/docs/getting-started/quickstart): Прогоните весь тулчейн от начала до конца примерно за тридцать секунд — офлайн, без API-ключа и не потратив ни одного токена.
  - [Ваше первое настоящее руководство](/ru/docs/getting-started/first-handbook): Восемь шагов от репозитория, который вы никогда не читали, до плана изменений, который можно применить — с дешёвыми контрольными точками в правильных местах.
  - [Словарь терминов](/ru/docs/getting-started/vocabulary): Этап, карточка, регистр, рабочий каталог, кейс, skill, план — каждое слово, которое этот проект использует в особом смысле, определено один раз.

- **Understanding it**
- Концепции
  - [Зачем это существует](/ru/docs/concepts/why): Сводка по кодовой базе не помогает агенту находить вещи. Помогает маршрутизация. Вот аргумент — и дизайн, который из него следует.
  - [Архитектура](/ru/docs/concepts/architecture): Одиннадцать пакетов в четырёх слоях, строго однонаправленные зависимости и границы, которые делают детерминированную половину переиспользуемой саму по себе.
  - [Пять фаз](/ru/docs/concepts/pipeline): Что делает каждая фаза генерации, сколько она стоит, во что деградирует при сбое и как перезапустить только одну из них.
  - [Рабочий каталог](/ru/docs/concepts/work-directory): Каждый артефакт, который производит конвейер: где он живёт, что его валидирует и что безопасно удалять.
  - [Достоверность анализа](/ru/docs/concepts/analysis-fidelity): Два уровня анализа производят внешне одинаковый результат. Это ловушка, поэтому каждый адаптер объявляет, что он способен выдать, а руководство это раскрывает.
  - [Чему можно доверять](/ru/docs/concepts/trust-model): Какие части руководства — разобранные парсером факты, какие — вывод модели, что покидает вашу машину и что инструмент отказывается делать.

- **Doing things**
- Руководства
  - [Генерация handbook](/ru/docs/guides/generating): Выбор детализации, режима синтеза и стратегии; запуск фаз по отдельности; возобновление; и что делать, когда результат неверен.
  - [Рендеринг результатов](/ru/docs/guides/rendering): Markdown, HTML-сайт, одна самодостаточная страница, локаторный индекс для агентов и llms.txt — всё детерминировано и бесплатно для повторного запуска.
  - [Упаковка для вашего агента](/ru/docs/guides/agent-skill): Превратите отрендеренный handbook в пакет SKILL с обнаружением дрейфа и подключите его к кодинг-агенту.
  - [Планирование изменения](/ru/docs/guides/planning-changes): Дайте планировщику запрос и handbook — получите байт-точный план правок и машиночитаемую декларацию того, чего он касается.
  - [Применение и откат](/ru/docs/guides/applying-changes): Механический исполнитель с четырьмя правилами безопасности, резервная копия, способная доказать, что она восстанавливает, и парсер, отвергающий всё неоднозначное.
  - [Поддержание актуальности](/ru/docs/guides/keeping-current): Resync сравнивает старый граф вызовов с новым и перегенерирует только то, что действительно изменилось. Тронули три файла — платите за три файла.
  - [Studio — веб-интерфейс](/ru/docs/guides/studio): Весь тулчейн во вкладке браузера, с живыми логами и откатом в один клик. Только localhost — намеренно.
  - [Настройка Handbooks](/ru/docs/guides/configuration): Пять уровней приоритета, один реестр и команда, которая точно скажет, какой уровень победил.
  - [Docker](/ru/docs/guides/docker): Запустите весь тулчейн без локальной установки Node — включая Studio, и один образ для всех окружений.
  - [Интеграция с CI](/ru/docs/guides/ci): Какие команды достаточно бесплатны, чтобы выполнять их на каждом коммите, каким нужен ключ, и как провалить сборку при дрейфе handbook.
  - [Стоимость и производительность](/ru/docs/guides/cost-and-performance): Куда на самом деле уходят токены, какие ручки действительно что-то меняют и как это выяснить до того, как потратить хоть что-нибудь.
  - [Устранение неполадок](/ru/docs/guides/troubleshooting): Что действительно ломается, что означает сообщение и что с этим делать.

- **Reference**
- Справочник
  - [Справочник CLI](/ru/docs/reference/cli): Каждая подкоманда, каждый флаг, его переменная окружения и значение по умолчанию — а также то, что каждая команда записывает и с каким кодом возврата завершается.
  - [Справочник конфигурации](/ru/docs/reference/configuration): Каждая настройка Handbooks — её флаг, переменная окружения, ключ в файле конфигурации, тип и значение по умолчанию — сгенерировано из реестра.
  - [Переменные окружения](/ru/docs/reference/environment): Каждая переменная, которую читает Handbooks, правило именования, которое их порождает, каскад .env и те, что никогда не должны попадать в файл конфигурации.
  - [Форматы артефактов](/ru/docs/reference/artifacts): Каждый файл, который пишет конвейер, его схема и то, что проверяет его при чтении.
  - [Поддержка языков](/ru/docs/reference/languages): 18 языков в двух уровнях анализа — какие расширения забирает каждый, чем жертвует обобщённый уровень и две оговорки, о которых стоит знать заранее.
  - [Каталог промптов](/ru/docs/reference/prompts): Каждый промпт, который отправляет инструментарий, о чём он просит и как каждый из них деградирует, когда ответ непригоден.
  - [Указатель пакетов](/ru/docs/reference/packages): Одиннадцать npm-пакетов, что экспортирует каждый и какие из них работают вообще без LLM.
  - [Коды возврата и вывод](/ru/docs/reference/exit-codes): Что означает каждый код возврата, что попадает в stdout, а что в stderr, и как писать скрипты под то и другое.

- **Contributing**
- Участие в разработке
  - [Разработка](/ru/docs/contributing/development): Сборка, шлюзы, конвенции, которые обеспечивает инструментарий, и почему тестам никогда не нужен ключ API.
  - [Добавление языка](/ru/docs/contributing/adding-a-language): Язык обобщённого уровня — это декларативная спецификация, а не парсер. Язык полного уровня — небольшой интерфейс. Ни тому ни другому не нужна новая зависимость.
  - [Выпуск релиза](/ru/docs/contributing/releasing): Версиями и списками изменений управляют changesets. Публикация остаётся бездействующей, пока не настроен токен, поэтому учёт в любом случае корректен.

# ドキュメント

- [Handbooks とは？](/ja/docs): 一つのコードベースから二冊のハンドブックを生成——チームが読む物語形式のドキュメントサイトと、コーディングエージェントがルーティングに使う位置インデックス。同じ解析済みの地図から作られ、コードの変化に追随します。

- **Getting started**
- はじめに
  - [インストール](/ja/docs/getting-started/installation): 必要なのは Node 20.11 と pnpm、それだけです。ネイティブコンパイルも Python も node-gyp も不要 — パーサーは WebAssembly です。
  - [クイックスタート](/ja/docs/getting-started/quickstart): ツールチェーン全体を約 30 秒でエンドツーエンドに実行します — オフラインで、API キーなし、トークン消費ゼロ。
  - [はじめての本格的なハンドブック](/ja/docs/getting-started/first-handbook): 一度も読んだことのないリポジトリから、適用できる変更プランまでの 8 ステップ — 安価なチェックポイントを適切な場所に配置しています。
  - [用語集](/ja/docs/getting-started/vocabulary): ステージ、カード、レジスタ、作業ディレクトリ、ケース、スキル、プラン — このプロジェクトが特定の意味で使うすべての言葉を、一度だけ定義します。

- **Understanding it**
- コンセプト
  - [なぜこれが存在するのか](/ja/docs/concepts/why): コードベースの要約は、エージェントが物事を見つける助けにはなりません。助けになるのはルーティングです。これはその論証と、そこから導かれる設計です。
  - [アーキテクチャ](/ja/docs/concepts/architecture): 4 つのレイヤーに 11 のパッケージ、厳密に一方向の依存方向、そして決定的な半分を単体で再利用可能にする境界。
  - [5 つのフェーズ](/ja/docs/concepts/pipeline): 各生成フェーズが何をするか、何を消費するか、失敗時に何へデグレードするか、そして 1 つだけ再実行する方法。
  - [作業ディレクトリ](/ja/docs/concepts/work-directory): パイプラインが生成するすべての成果物、その置き場所、何がそれを検証するか、そして何を消しても安全か。
  - [解析忠実度](/ja/docs/concepts/analysis-fidelity): 2 つの解析ティアは、見た目のまったく同じ出力を生みます。それは罠なので、すべてのアダプタは自分の提供できるものを宣言し、ハンドブックはそれを開示します。
  - [何を信頼できるか](/ja/docs/concepts/trust-model): ハンドブックのどの部分がパースされた事実で、どの部分がモデルの出力か。何があなたのマシンを離れるか。そして、このツールが何を拒否するか。

- **Doing things**
- ガイド
  - [ハンドブックの生成](/ja/docs/guides/generating): 詳細度・合成モード・戦略の選び方、フェーズの個別実行、再開、そして結果が間違っていたときの対処。
  - [出力のレンダリング](/ja/docs/guides/rendering): Markdown、HTML サイト、単一の自己完結ページ、エージェント用ロケータインデックス、llms.txt — すべて決定的で、何度でも無料で再実行できます。
  - [エージェント向けのパッケージング](/ja/docs/guides/agent-skill): レンダリング済みハンドブックをドリフト検出付きの SKILL パッケージに変換し、コーディングエージェントに組み込みます。
  - [変更の計画](/ja/docs/guides/planning-changes): プランナーにリクエストとハンドブックを渡すと、バイト単位で正確な編集プランと、何に触れるかの機械可読な宣言が返ってきます。
  - [適用とロールバック](/ja/docs/guides/applying-changes): 4 つの安全ルールを持つ機械的な実行器、何を復元するかを証明できるバックアップ、そして曖昧なものを一切拒否するパーサー。
  - [最新に保つ](/ja/docs/guides/keeping-current): 再同期は古いコールグラフを新しいものと突き合わせ、実際に変わったものだけを再生成します。3 ファイル触れたら、3 ファイル分の支払いです。
  - [Studio — Web UI](/ja/docs/guides/studio): ツールチェーン全体をブラウザのタブ 1 つで。ライブログとワンクリックのロールバック付き。設計上、localhost 専用です。
  - [Handbooks の設定](/ja/docs/guides/configuration): 5 つの優先順位レイヤー、1 つのレジストリ、そしてどのレイヤーが勝ったかを正確に教えてくれるコマンド。
  - [Docker](/ja/docs/guides/docker): ローカルに Node をインストールせずにツールチェーン全体を実行 — Studio も含めて、すべての環境で 1 つのイメージ。
  - [CI 統合](/ja/docs/guides/ci): どのコマンドがコミットごとに実行できるほど無料で、どれにキーが必要か、そしてハンドブックのドリフトでビルドを失敗させる方法。
  - [コストとパフォーマンス](/ja/docs/guides/cost-and-performance): トークンが実際にどこへ行くのか、どのノブが効くのか、そして支払う前に見積もる方法。
  - [トラブルシューティング](/ja/docs/guides/troubleshooting): 実際に起きる問題、メッセージの意味、そしてその対処法。

- **Reference**
- リファレンス
  - [CLI リファレンス](/ja/docs/reference/cli): すべてのサブコマンド、すべてのフラグ、その環境変数とデフォルト値 — さらに各コマンドが何を書き出し、どの終了コードで終わるか。
  - [設定リファレンス](/ja/docs/reference/configuration): Handbooks のすべての設定を、フラグ・環境変数・設定ファイルのキー・型・デフォルトとともに掲載 — レジストリから生成されています。
  - [環境変数](/ja/docs/reference/environment): Handbooks が読み取るすべての変数、それらを生成する命名規則、.env のカスケード、そして設定ファイルに決して入れてはならないもの。
  - [アーティファクト形式](/ja/docs/reference/artifacts): パイプラインが書き出すすべてのファイル、そのスキーマ、そして読み込み時に検証するもの。
  - [言語サポート](/ja/docs/reference/languages): 2 つの解析ティアにまたがる 18 言語 — それぞれがどの拡張子を引き受けるのか、generic ティアが何を諦めているのか、そして踏み抜く前に知っておく価値のある 2 つの注意点。
  - [プロンプトカタログ](/ja/docs/reference/prompts): ツールチェーンが送るすべてのプロンプト、それぞれが何を求めるのか、そして返信が使えないときにどう劣化するのか。
  - [パッケージ索引](/ja/docs/reference/packages): 11 個の npm パッケージ、それぞれが何を export するのか、そしてそのうちどれが LLM 無しでも動くのか。
  - [終了コードと出力](/ja/docs/reference/exit-codes): 各終了コードの意味、stdout と stderr のどちらに何が流れるか、そして両方を前提にスクリプトを書く方法。

- **Contributing**
- コントリビュート
  - [開発](/ja/docs/contributing/development): ビルド、ゲート、ツールが強制する規約、そしてテストが API キーを一切必要としない理由。
  - [言語を追加する](/ja/docs/contributing/adding-a-language): generic ティアの言語はパーサーではなく宣言的な仕様です。full ティアの言語は小さなインターフェースです。どちらも新しい依存関係を必要としません。
  - [リリース](/ja/docs/contributing/releasing): changesets がバージョンと変更履歴を駆動します。トークンが設定されるまで公開は何もしないため、どちらにせよ帳簿は正しいままです。

# Dokumentation

- [Was ist Handbooks?](/de/docs): Eine Codebasis rein, zwei Handbücher raus — eine erzählte Doku-Site für dein Team und ein Orts-Index, mit dem dein Coding-Agent navigiert. Aus derselben geparsten Karte, immer aktuell zum Code.

- **Getting started**
- Erste Schritte
  - [Installation](/de/docs/getting-started/installation): Node 20.11 und pnpm — das ist die ganze Liste. Keine native Kompilierung, kein Python, kein node-gyp: die Parser sind WebAssembly.
  - [Schnellstart](/de/docs/getting-started/quickstart): Die gesamte Toolchain in rund dreißig Sekunden von Anfang bis Ende — offline, ohne API-Schlüssel und ohne einen einzigen Token.
  - [Das erste echte Handbuch](/de/docs/getting-started/first-handbook): Acht Schritte von einem nie gelesenen Repository zu einem anwendbaren Änderungsplan — mit den günstigen Kontrollpunkten an den richtigen Stellen.
  - [Das Vokabular](/de/docs/getting-started/vocabulary): Etappe, Karte, Register, Arbeitsverzeichnis, Case, Skill, Plan — jedes Wort, das dieses Projekt in einem bestimmten Sinn verwendet, einmal definiert.

- **Understanding it**
- Konzepte
  - [Warum es das gibt](/de/docs/concepts/why): Eine Codebasis zusammenzufassen hilft einem Agenten nicht beim Finden. Routing schon. Das ist das Argument — und das Design, das daraus folgt.
  - [Architektur](/de/docs/concepts/architecture): Elf Pakete in vier Schichten, eine strikt einbahnige Abhängigkeitsrichtung und die Grenzen, die die deterministische Hälfte eigenständig wiederverwendbar machen.
  - [Die fünf Phasen](/de/docs/concepts/pipeline): Was jede Generierungsphase erzeugt, was sie kostet, worauf sie bei einem Fehlschlag degradiert und wie sich eine einzelne Phase erneut ausführen lässt.
  - [Das Arbeitsverzeichnis](/de/docs/concepts/work-directory): Jedes Artefakt, das die Pipeline erzeugt: wo es liegt, was es validiert und was sich gefahrlos löschen lässt.
  - [Analysetreue](/de/docs/concepts/analysis-fidelity): Zwei Analyse-Tiers erzeugen identisch aussehende Ausgabe. Das ist eine Falle — deshalb deklariert jeder Adapter, was er liefern kann, und das Handbook legt es offen.
  - [Worauf Verlass ist](/de/docs/concepts/trust-model): Welche Teile eines Handbook geparste Fakten sind, welche Modellausgabe, was Ihren Rechner verlässt und was das Werkzeug verweigert.

- **Doing things**
- Leitfäden
  - [Ein Handbook generieren](/de/docs/guides/generating): Detailgrad, Synthesemodus und Strategie wählen; Phasen einzeln ausführen; Läufe fortsetzen; und was zu tun ist, wenn das Ergebnis falsch ist.
  - [Ausgaben rendern](/de/docs/guides/rendering): Markdown, eine HTML-Site, eine einzelne in sich geschlossene Seite, der Agent-Locator-Index und llms.txt — alles deterministisch, alles kostenlos wiederholbar.
  - [Für Ihren Agenten paketieren](/de/docs/guides/agent-skill): Ein gerendertes Handbooks in ein SKILL-Paket mit Drift-Erkennung verwandeln und in einen Coding-Agenten einbinden.
  - [Eine Änderung planen](/de/docs/guides/planning-changes): Geben Sie dem Planner eine Anfrage und ein Handbook; zurück kommt ein byte-genauer Bearbeitungsplan samt maschinenlesbarer Deklaration dessen, was er anfasst.
  - [Anwenden und Rollback](/de/docs/guides/applying-changes): Ein mechanischer Ausführer mit vier Sicherheitsregeln, ein Backup, das beweisen kann, was es wiederherstellt, und ein Parser, der alles Mehrdeutige ablehnt.
  - [Aktuell halten](/de/docs/guides/keeping-current): Resync vergleicht den alten Aufrufgraphen mit dem neuen und regeneriert nur, was sich tatsächlich geändert hat. Drei Dateien angefasst, für drei Dateien bezahlt.
  - [Studio — die Web-UI](/de/docs/guides/studio): Die ganze Toolchain in einem Browser-Tab, mit Live-Logs und Ein-Klick-Rollback. Nur localhost, mit Absicht.
  - [Handbooks konfigurieren](/de/docs/guides/configuration): Fünf Vorrangebenen, eine Registry und ein Befehl, der Ihnen genau sagt, welche Ebene gewonnen hat.
  - [Docker](/de/docs/guides/docker): Die ganze Toolchain ohne lokale Node-Installation ausführen — einschließlich Studio, und ein Image für jede Umgebung.
  - [CI-Integration](/de/docs/guides/ci): Welche Befehle günstig genug sind, um bei jedem Commit zu laufen, welche einen Schlüssel brauchen, und wie ein Build bei Handbooks-Drift fehlschlägt.
  - [Kosten und Performance](/de/docs/guides/cost-and-performance): Wohin die Tokens tatsächlich fließen, welche Stellschrauben wirklich etwas bewegen, und wie Sie es herausfinden, bevor Sie irgendetwas ausgeben.
  - [Fehlerbehebung](/de/docs/guides/troubleshooting): Die Dinge, die tatsächlich schiefgehen, was die Meldung bedeutet, und was dagegen zu tun ist.

- **Reference**
- Referenz
  - [CLI-Referenz](/de/docs/reference/cli): Jeder Unterbefehl, jedes Flag, seine Umgebungsvariable und sein Standardwert — dazu, was jeder Befehl schreibt und mit welchem Exit-Code er endet.
  - [Konfigurationsreferenz](/de/docs/reference/configuration): Jede Handbooks-Einstellung mit ihrem Flag, ihrer Umgebungsvariable, ihrem Konfigurationsdatei-Schlüssel, Typ und Standardwert — generiert aus der Registry.
  - [Umgebungsvariablen](/de/docs/reference/environment): Jede Variable, die Handbooks liest, die Benennungsregel, die sie erzeugt, die .env-Kaskade und die, die nie in eine Konfigurationsdatei gehören.
  - [Artefakt-Formate](/de/docs/reference/artifacts): Jede Datei, die die Pipeline schreibt, ihr Schema und was sie beim Lesen validiert.
  - [Sprachunterstützung](/de/docs/reference/languages): 18 Sprachen in zwei Analysestufen — welche Endungen jede beansprucht, worauf die generische Stufe verzichtet, und die zwei Vorbehalte, die man kennen sollte, bevor man auf sie stößt.
  - [Prompt-Katalog](/de/docs/reference/prompts): Jeder Prompt, den die Werkzeugkette sendet, worum er bittet und wie jeder einzelne degradiert, wenn die Antwort unbrauchbar ist.
  - [Paketverzeichnis](/de/docs/reference/packages): Elf npm-Pakete, was jedes exportiert und welche davon ganz ohne LLM funktionieren.
  - [Exit-Codes und Ausgabe](/de/docs/reference/exit-codes): Was jeder Exit-Code bedeutet, was nach stdout und was nach stderr geht, und wie man gegen beides skriptet.

- **Contributing**
- Mitwirken
  - [Entwicklung](/de/docs/contributing/development): Der Build, die Gates, die Konventionen, die das Werkzeug erzwingt, und warum die Tests nie einen API-Schlüssel brauchen.
  - [Eine Sprache hinzufügen](/de/docs/contributing/adding-a-language): Eine Sprache der generischen Stufe ist eine deklarative Spezifikation, kein Parser. Eine der vollen Stufe ist ein kleines Interface. Beide brauchen keine neue Abhängigkeit.
  - [Veröffentlichen](/de/docs/contributing/releasing): Changesets steuern Versionen und Changelogs. Das Veröffentlichen bleibt untätig, bis ein Token konfiguriert ist, sodass die Buchführung in jedem Fall stimmt.