Decision Records (ADRs)
Strategische und architektonische Entscheidungen die in 2 Jahren noch nachvollziehbar sein sollen. Frage: „Warum machen wir X so?”
Body-Pflicht-Sections in jedem File: ## Kontext · ## Optionen · ## Entscheidung · ## Konsequenzen. Frontmatter-Schema: 54-decision-record-adr.
Architektur
| ADR | Status | Stand | Pointer |
|---|---|---|---|
| zugriffsmodell | accepted | 2026-04-17 | Multi-User-Vault + Kunden-Trennung — Diagramme + Defense-in-Depth |
| agent-native-architektur | accepted | 2026-04-17 | Folder-as-Architecture, Markdown statt DB |
| runner-architektur | accepted | 2026-04-17 | LLM-Agnostik-Layer (Adapter-Pattern, LiteLLM-Proxy) |
Geschaeftsmodell
| ADR | Status | Stand | Pointer |
|---|---|---|---|
| keine-eigene-plattform | accepted | 2026-05-09 | Plattform-Bau eingestellt (Voit/HeyJulia/julia_v2/agentic-os archiviert). Service-Modell mit Brain + MCPs pro Kunde — wie Becker, aber mit AI |
| sonder-konditionen-kunden | accepted | 2026-05-12 | Wann darf ein Kunde ausserhalb des Standard-Pricing laufen? VF (Self-Cost, Freunde) und Becker (Tueroeffner mit Service-Sockel) sind die zwei Ausnahmen, mit klaren Schutzklauseln |
Hosting & Compliance
| ADR | Status | Stand | Pointer |
|---|---|---|---|
| aws-multi-account-strategie | accepted | 2026-05-07 | AWS Multi-Account-Org als Hosting-Standard, Railway wird abgeloest. Ein Sub-Account pro Kunde, Identity Center zentral, Org-Trail im Mgmt |
| ecs-express-statt-app-runner | accepted | 2026-05-09 | ECS Express Mode statt App Runner (closed) / klassisches Fargate fuer hosted MCPs. AWS-managed ALB+TLS+AutoScaling, ALB-Sharing ueber bis zu 25 Services |
| markdown-und-db-trennung | accepted | 2026-05-10 | Hybrid-Persistenz pro Kunden-Tenant — S3-Markdown-Vault fuer Knowledge, DynamoDB fuer Operational. Daten-Souveraenitaet plus ACID-Konsistenz wo noetig |
| service-first-zu-produkt | accepted | 2026-05-10 | Drei-Phasen-Modell — Service mit produktisierten Bausteinen (jetzt-Sommer 2026), Standardisierung (Sommer-Herbst 2026), Self-Service-Tier mit Stripe (Q4 2026). Konsistent mit ADR keine-eigene-plattform |
| llm-hosting-eu-optionen | accepted | 2026-04-27 | 3 Optionen — Bedrock vs Mistral La Plateforme vs Self-Hosted Hetzner. Default: Mistral fuer DSGVO-strenge Industriekunden |
| anthropic-datenschutz | accepted | 2026-04-21 | Produkt-Matrix Anthropic, Pflicht-Schritte DSGVO, Zero-Retention, Kunden-Checkliste |
| claude-dsgvo-setup | accepted | 2026-04-20 | Technischer Setup-Guide AWS Bedrock eu-central-1 + LibreChat (~25 min Setup) |
| bedrock-eu-image-gen-limitation | accepted | 2026-05-12 | Bedrock-eu-central-1 hat keine Image-Gen-Models — Image-Gen via Replicate-MCP statt Bedrock-direkt |
| eu-ai-act-pflichten | accepted | 2026-04-27 | EU AI Act / KI-Verordnung — 4 Risikostufen, Annex-III, KI-Kompetenz, Anbieter-vs-Deployer-Pflichten, Zeitachse mit Digital-Omnibus-Verschiebung Hochrisiko auf Dez 2027 |
Verwandte Entscheidungen (verlinkt aus anderen Bereichen)
| Thema | Wo |
|---|---|
| Buchhaltungs-Tool-Stack (Qonto + Papierkram + sevDesk-Backup) | buchhaltungs-stack |
| Mono-MCP-Hosting-Pattern (Scalekit + create_proxy) | mcp-vf-hosted |
| Custom Connector in claude.ai — Constraints | claude-custom-connector |
| HTTP als MCP-Default-Transport | (in _index Regeln) |
| Service-Modell-Strategie (Service + Befaehigung statt Lizenz, Icking-Pivot) | positioning |
Konvention bei neuer Entscheidung
- Datei
<slug>.mdmit Frontmatter Schema 5.4 (id: adr-YYYY-NNN,type: decision_record,status,deciders,context,date,supersedes) - Body mit den 4 Pflicht-Sections
- Eintrag in diesem Index mit Pointer
- Wenn die Entscheidung in einem anderen Bereich (Capability, Kunde, Firma) wirksam wird: Cross-Ref dort
Related
- _context — Wissens-Hub
- 54-decision-record-adr — Schema