Name		Name	Last commit message	Last commit date
parent directory ..
.local		.local
decisions		decisions
runbooks		runbooks
ui		ui
2026-05-19-pytest-cve-tracking-arbeitsprotokoll.md		2026-05-19-pytest-cve-tracking-arbeitsprotokoll.md
AUDIT_REPORT_MAY_2026.md		AUDIT_REPORT_MAY_2026.md
README.md		README.md
ROADMAP.md		ROADMAP.md
STATUS.md		STATUS.md
agent-tools.md		agent-tools.md
analytics.md		analytics.md
api-contracts.md		api-contracts.md
architecture.md		architecture.md
audit-followup-issues.md		audit-followup-issues.md
auth.md		auth.md
backup-restore.md		backup-restore.md
ci-egress-allowlist.md		ci-egress-allowlist.md
dependency-risk-register.md		dependency-risk-register.md
deployment-dev.md		deployment-dev.md
deployment-prod-like.md		deployment-prod-like.md
deployment.md		deployment.md
embedding-provider-switch.md		embedding-provider-switch.md
feature-roadmap.md		feature-roadmap.md
glossary.md		glossary.md
graphrag-speedup.md		graphrag-speedup.md
operations.md		operations.md
operator-guide.md		operator-guide.md
provider-runtime-settings.md		provider-runtime-settings.md
refactoring-backlog.md		refactoring-backlog.md
release-process.md		release-process.md
secret-key-lifecycle.md		secret-key-lifecycle.md
security-hardening.md		security-hardening.md
security-threat-model.md		security-threat-model.md

README.md

Agora — Dokumentation

Lebende Doku für das Agora-Projekt. Worklogs und Arbeitsprotokolle liegen unter archive/ und sind nicht für den Einstieg gedacht.

Einstieg

Projekt-Übersicht und Quickstart: ../README.md
Mitarbeit: ../CONTRIBUTING.md
Sicherheitsmeldungen: ../SECURITY.md
Agenten-Konfiguration (Claude Code, Codex): ../AGENTS.md
Roadmap und Slice-Plan: ../PLAN.md

Architektur und API

architecture.md — Ziel-Architektur, Layer-Modell, Komponenten
agent-tools.md — Integration von Agent-Tools (CAMEL, OASIS)
api-contracts.md — Pydantic-Contracts + Zod-Spiegel
glossary.md — Wording-Glossar (Layer 2)

Development

deployment-dev.md — Lokales Dev-Setup
provider-runtime-settings.md — LLM-/Embedding-Provider
embedding-provider-switch.md — Wechsel des Embedding-Modells
analytics.md — Auswertungspfade
graphrag-speedup.md — Performance-Tuning Graph

Deployment und Operations

deployment.md — Produktions-Deployment
deployment-prod-like.md — Prod-like Stack lokal
release-process.md — Release-Cut, Tagging
operations.md — Betrieb
operator-guide.md — Operator-Aufgaben
backup-restore.md — Backup-Strategie

Security

security-hardening.md — Hardening-Maßnahmen
security-threat-model.md — Bedrohungsmodell
secret-key-lifecycle.md — Schlüssel-Rotation
auth.md — Authentifizierung
dependency-risk-register.md — Offene CVE-Watchlist

Runbooks (für Mitwirkende und Agenten)

runbooks/ — PR-Workflow, Subagent-Routing, Worktree-Strategie, Tool-Pflicht

Architekturentscheidungen (ADRs)

decisions/ — Stabile Architekturentscheidungen

Status und Planung

STATUS.md — Aktueller Slice- und Test-Status
ROADMAP.md — Mittelfristige Roadmap
feature-roadmap.md — Feature-Pipeline
refactoring-backlog.md — Refactoring-Backlog
plans/ — Aktive Slice-Pläne (Observability u. a.)

Design

design/ — Design-Language v4, Komponenten-Token
ui/ — UI-Konzepte und Wireframes

Archiv

archive/worklogs/ — Historische Arbeitsprotokolle (~340 Stück)
archive/plans/ — Abgeschlossene oder ersetzte Pläne
archive/sessions/, archive/history/, archive/logs/, archive/prompts/, archive/manual-smoke/ — Historische Materialien
archive/root-junk/ — Aus dem Repo-Root verschobene Ad-hoc-Dokumente