Einführung

← Zurück zur Übersicht

1. Möglicher technischer Stack

Ein möglicher Start-Stack:

Git Repositories
GitHub/GitLab/Bitbucket Webhooks
CI/CD Pipeline
AURA Ingest Service
docs/aura Markdown
Mermaid oder PlantUML
ADRs
OpenAPI / AsyncAPI
architecture.yaml
Nuxt Content oder MkDocs Material
Search Index
Vector Database
Graph Model
MCP Server
Jira Integration

Optional später:

Structurizr DSL
Backstage Integration
Graphdatenbank
Policy-as-Code
LLM-basierte Drift-Erkennung
Automatische ADR-Vorschläge
Automatische Diagramm-Vorschläge

2. Einführung in Phasen

AURA sollte nicht mit maximaler Governance starten. Empfohlene Phasen:

Phase 1: Dokumentationsstandard

• docs/aura/ als Repo-Standard einführen
• Aura-Skill für Brownfield-Recherche nutzen
• Konfidenzmarker und AURA-TODO-Marker zulassen
• architecture.yaml optional ergänzen
• ADR- und C4-Minimalstandard in 02-architecture/ verankern

Phase 2: Zentrale Webseite

• AURA Ingest für docs/aura/ bauen
• Snapshots mit Quellpfaden und Commit erzeugen
• Webseite aus Content Source generieren
• Service-Katalog anzeigen
• Links zu Repos und Jira herstellen

Phase 3: PR Checks

• AURA bei Pull Requests triggern
• fehlende Doku kommentieren
• API-/Dependency-Änderungen erkennen
• zunächst nur Warnungen erzeugen

Phase 4: AI Context Layer

• Suchindex erstellen
• Embeddings erzeugen
• Quellenmetadaten pflegen
• KI-Assistent anbinden
• Antworten mit Quellen ermöglichen

Phase 5: MCP Server

• AURA Resources bereitstellen
• AURA Tools bereitstellen
• standardisierte Prompts bereitstellen
• externe KI-Clients anbinden

Phase 6: Governance und Gates

• harte Checks für kritische Services
• Policy-as-Code
• Drift-Erkennung
• regelmäßige Review-Fristen
• Qualitätsmetriken

3. Minimum Viable AURA

Ein sinnvoller MVP startet klein.

MVP-Bausteine:

1. docs/aura/ pro Repository
2. Aura-Skill für initiale Research-First-Drafts
3. C4 Context und Container in 02-architecture/
4. ADRs in 02-architecture/decisions/
5. AURA Ingest Service
6. AURA Repository mit Snapshots
7. zentrale Webseite aus Content Source
8. einfacher PR Check für fehlende docs/aura-Änderungen
9. Volltextsuche und einfache Jira-/Repo-Links

Noch nicht im MVP nötig:

vollständiger MCP Server
Graphdatenbank
automatische Drift-Erkennung
harte Merge-Gates
komplexe Embeddings
vollautomatische KI-Doku-Erzeugung

4. Beispielhafter MVP-Flow

1. Repo enthält docs/aura/README.md und docs/aura/02-architecture/overview.md.
2. Entwickler öffnet PR.
3. AURA prüft, ob bei relevanten Codeänderungen auch docs/aura/ oder architecture.yaml geändert wurde.
4. AURA kommentiert im PR, falls nicht.
5. Nach Merge zieht AURA die Doku.
6. AURA erzeugt Snapshot mit Commit-ID.
7. Die zentrale Webseite wird neu gebaut.
8. Entwickler können zentrale Service-Übersicht lesen.

5. AURA und DORA

AURA passt gut zu den Erkenntnissen aus DORA im KI-Zeitalter.

Die Grundidee:

KI erhöht die Geschwindigkeit. Ohne gute Plattformen, klare Ownership, kleine Änderungen, Versionierung und zugängliches internes Wissen steigt aber auch das Chaos.

AURA stärkt genau diese Grundlagen:

• Versionierung
• kleine überprüfbare Änderungen
• interne Plattformfähigkeit
• zugängliche Dokumentation
• schnelle Feedback-Loops
• menschliche Kontrolle

AURA ist damit kein KI-Spielzeug, sondern ein organisatorisches Kontroll- und Verständniswerkzeug für KI-beschleunigte Softwareentwicklung.

6. Nächster sinnvoller Schritt

Der nächste Schritt wäre nicht sofort die technische Implementierung, sondern die Definition des Standards.

Konkret ist der nächste sinnvolle Schritt:

1. Aura-Skill herunterladen und in einem Brownfield-Repository testen.
2. docs/aura/ vom Skill vorbefüllen lassen.
3. Gap-Report und AURA-TODO-Marker mit dem Team reviewen.
4. PR-Regeln zunächst als Warnungen aktivieren.
5. Ingest nur für validierte main-Stände bauen.
6. Die zentrale Webseite aus diesen validierten Quellen erzeugen.

Erst danach sollte ein MVP gebaut werden.

Weiterlesen

• Nächste Seite: Abgrenzung und Risiken — was bei der Einführung schiefgehen kann
• Aura Skill — Skill herunterladen und ausprobieren
• Vorlagen und Skill — Templates für den Phase-1-Start
• Zusammenfassung — Kernaussagen kompakt

← Zurück zur Übersicht