docs: restructure domain documentation and update references

Implemented a standardized folder structure for domain documentation to improve clarity and maintainability. Migrated existing files to the new structure, updated links in related documentation, and added README files for navigation and guidance.
This commit is contained in:
2026-01-15 13:44:49 +01:00
parent 7d71ca9a48
commit a454e6c97a
66 changed files with 881 additions and 693 deletions
+4 -16
View File
@@ -5,17 +5,13 @@ Dieses Verzeichnis enthält die **kurze Start-Anweisung** für Gemini (parallel/
## Single Source of Truth
* **Projektwissen & Entscheidungen:** `docs/`
* `.junie/` ist nur Tooling/Guardrails, keine zweite Wahrheit.
* `.gemini/` und `.junie/` sind nur Tooling/Guardrails, keine zweite Wahrheit.
## Startreihenfolge (Pflicht)
1. `docs/README.md`
2. `docs/03_Agents/README.md` (Artefakt-Vertrag)
3. Relevanter technischer Bereich (pro System):
* Architektur: `docs/01_Architecture/`
* Backend (Services): `docs/04_Backend/Services/`
* Frontend: `docs/05_Frontend/`
* Infrastruktur: `docs/06_Infrastructure/`
1. `docs/README.md` (Gesamtstruktur)
2. `docs/04_Agents/README.md` (Artefakt-Vertrag & Arbeitsmodus)
3. `AGENTS.md` (Übersicht der Rollen und Links zu den Playbooks)
## Output-Regel (Anti-Wissensverlust)
@@ -25,11 +21,3 @@ Jede Gemini-Session endet mit **genau einem** Artefakt in `docs/`:
* `Reference` (passender Bereich)
* `How-to / Runbook` (passender Bereich)
* `Journal Entry` (`docs/99_Journal/`)
## Technische Wahrheit „pro System“
Für Services gilt: Eine stabile, nicht-datierte Seite unter `docs/04_Backend/Services/` ist der Einstieg.
Zeitlich datierte Detailanalysen liegen unter `docs/90_Reports/`.
Beispiel:
* Ping-Service: `docs/04_Backend/Services/ping-service.md`