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:
+4
-16
@@ -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`
|
||||
|
||||
Reference in New Issue
Block a user