..  include:: /Includes.rst.txt

.. _adrs:

=============================
Architecture decision records
=============================

Architecture Decision Records (ADRs) document the key design choices made
during development, including the context, alternatives considered, and
consequences of each decision.

..  toctree::
    :maxdepth: 1

    ADR-001-embedded-mcp-client-in-typo3-backend
    ADR-002-cli-based-message-processing
    ADR-003-mcp-integration-via-stdio-subprocess
    ADR-004-nr-llm-as-llm-abstraction-layer
    ADR-005-persistent-conversation-model-with-state-machine
    ADR-006-layered-architecture-with-phpat-enforcement
    ADR-007-polling-over-websockets-or-sse
    ADR-008-lit-web-components-without-build-step
    ADR-009-group-based-access-control
    ADR-010-llm-error-message-sanitization
    ADR-011-floating-panel-outside-module-iframe
    ADR-012-markdown-rendering-with-marked-and-dompurify
    ADR-013-server-side-document-text-extraction-fallback
    ADR-014-configurable-mcp-server-registry