Migrate all repos into monorepo context folders

Bahn: aisupport, Analyse-O2C-C2S, awesome-bahn-mcp-servers, beam-mcp, Confluence_Bot, db-planet-mcp-server, O2C-Harness, project-audit, Projekt-KIQ-HP, teamlandkarte-mcp Dhive: Jury-Voting Privat: CV, NoteGraph (NOTE: NoteGraph needs complete redo after consolidation) Shared: AI-Orchestrator, OrgMyLife, power_skills_and_more Shared/references: symphony (read-only) Bahn repos remain available as independent remotes - this monorepo pulls them in via subtree, the originals are untouched.
2026-06-30 20:39:52 +02:00
parent 2f2b295531
commit a5f8fb49ab
1717 changed files with 447332 additions and 0 deletions
@@ -0,0 +1,228 @@
+# AI Support - Prompts, Steering Files & Skills
+
+Sammlung von Prompts, Steering-Dateien und Skills für die Arbeit mit AI-Assistenten und LLMs.
+
+## Inhaltsverzeichnis
+
+- [Überblick](#überblick)
+- [Struktur](#struktur)
+- [Steering Files](#steering-files)
+- [Prompts](#prompts)
+- [Skills](#skills)
+- [Verwendung](#verwendung)
+- [Beitragen](#beitragen)
+
+## Überblick
+
+Dieses Repository enthält wiederverwendbare Bausteine für die effektive Nutzung von
+AI-Assistenten wie Kiro:
+
+- **Steering Files** — kontextuelle Anleitung, die in Sessions automatisch oder manuell eingebunden wird
+- **Prompts** — fertige Prompt-Vorlagen für wiederkehrende Aufgaben
+- **Skills** — abgeschlossene, ausführbare Pakete mit Workflow, Assets und Code (z. B. PowerPoint-Generator)
+
+Alle Bausteine sind so strukturiert, dass sie einfach in verschiedene Projekte übernommen werden können.
+
+## Struktur
+
+```
+.
+├── steering/                    # Steering-Dateien für AI-Assistenten
+│   ├── agent-behaviour.md      # Grundlegende Verhaltensregeln
+│   ├── codebase-summary.sop.md # SOP für Codebase-Dokumentation
+│   ├── einfachbahn-naming.md   # Schreibweise #Einfachbahn (always)
+│   └── onboarding-dokumentation.md # Onboarding-Dokumentation erstellen
+├── powers/                      # Kiro Powers (on-demand Plattformwissen)
+│   ├── db-dxp-platform/        # DXP-Ökosystem-Nachschlagewerk
+│   ├── db-openshift-deploy/    # Manuelles OpenShift-Deployment
+│   ├── db-pipeship-onboarding/ # pipeship CI/CD Setup
+│   └── db-scm-info-compliance/ # scm-info.yaml + Compliance Suite
+├── prompts/                     # Wiederverwendbare Prompts
+│   └── unit-tests-motivation.md # Anleitung für Unit-Test-Erstellung
+├── skills/                      # Self-contained Skills (Workflow + Assets + Code)
+│   └── pptx-infrago/           # PowerPoint im DB InfraGO Corporate Design
+└── README.md
+```
+
+## Steering Files
+
+Steering-Dateien bieten kontextuelle Anleitung für AI-Assistenten während der gesamten Interaktion.
+
+### agent-behaviour.md
+Grundlegende Verhaltensregeln für AI-Assistenten:
+- Code-Überprüfung bei Unsicherheit
+- Klärende Fragen stellen
+
+**Verwendung:** Wird automatisch global eingebunden
+
+### codebase-summary.sop.md
+Standard Operating Procedure für die Erstellung umfassender Codebase-Dokumentation:
+- Automatische Analyse von Architektur und Komponenten
+- Generierung von AGENTS.md, README.md, CONTRIBUTING.md
+- Update-Modus für inkrementelle Aktualisierungen
+- Mermaid-Diagramme für Visualisierungen
+
+**Verwendung:** Wird automatisch global eingebunden
+
+### einfachbahn-naming.md
+Schreibweise des Teamnamens `#Einfachbahn` — immer mit Hashtag, großem E, keine Leerzeichen.
+
+**Verwendung:** Wird automatisch global eingebunden
+
+### onboarding-dokumentation.md
+Strukturierter Plan für die Erstellung von Onboarding-/Migrationsdokumentation:
+- 7-Schritte-Prozess mit Fortschrittsverfolgung
+- Fokus auf fachliche End-to-End-Flüsse
+- Externe Schnittstellen und Datenmodelle
+- Mermaid-Diagramme für alle Visualisierungen
+
+**Verwendung:** `#onboarding-dokumentation` im Chat referenzieren
+
+## Powers
+
+Powers liefern gebündeltes Plattformwissen, das Kiro bei passenden Fragen on-demand aktiviert.
+Quelle: [einfachbahn-lab/kiro_tools/power_skills_and_more](https://git.tech.rz.db.de/einfachbahn-lab/kiro_tools/power_skills_and_more)
+
+| Power | Zweck |
+|-------|-------|
+| `db-openshift-deploy` | Manuelles Deployment: Docker → Artifactory → OpenShift |
+| `db-pipeship-onboarding` | Repo mit pipeship aufsetzen (CI/CD, K8s, Trivy, Renovate) |
+| `db-dxp-platform` | DXP-Ökosystem-Nachschlagewerk (pipeship, CDaaS, Portal) |
+| `db-scm-info-compliance` | `scm-info.yaml` erstellen/validieren + Compliance-Checks |
+
+**Installation:** Power-Ordner über Kiro Powers-UI als „Local Directory" hinzufügen.
+Details: [`powers/README.md`](powers/README.md)
+
+## Prompts
+
+### unit-tests-motivation.md
+Umfassende Anleitung für die Erstellung qualitativ hochwertiger Unit Tests:
+- JUnit 5 + Mockito Guidelines
+- AAA-Pattern (Arrange-Act-Assert)
+- 80%+ Code Coverage Ziel
+- Constraints und Best Practices
+- Verifizierung und Troubleshooting
+
+**Verwendung:** `#unit-tests-motivation` im Chat referenzieren
+
+## Skills
+
+Skills sind self-contained Pakete nach der [Agent Skills Specification](https://agentskills.io/specification):
+ein `SKILL.md` mit Workflow plus mitgelieferte Assets und Code. Im Gegensatz zu Steering-Dateien
+oder Prompts bringt ein Skill alles mit, was zur Ausführung gebraucht wird.
+
+### pptx-infrago
+PowerPoint-Präsentationen (`.pptx`) im DB InfraGO Corporate Design mit Python:
+- Nutzt den offiziellen DB InfraGO Folienmaster (31 Layouts) — Logo, Footer, Foliennummer und Farben kommen automatisch vom Master
+- Eine Funktion pro Layout im Helper-Modul `db_infrago_pptx.py`
+- 10 mitgelieferte Hintergrundbilder mit thematischer Auswahl-Heuristik
+- Geführter 5-Schritte-Workflow: Infos sammeln → Bild wählen → Gliederung → Skript generieren → ausführen und öffnen
+
+**Verwendung:** Skill-Ordner nach `~/.kiro/skills/pptx-infrago/` (global) oder
+`<projekt>/.kiro/skills/pptx-infrago/` (projektspezifisch) kopieren. Aktivierung
+durch Keywords wie „PowerPoint", „PPTX", „Foliensatz" oder explizit per
+`@pptx-infrago` im Chat.
+
+Voraussetzung: `pip install python-pptx`
+
+## Verwendung
+
+### In Kiro
+
+1. **Globale Steering Files:** 
+   - Kopiere Dateien nach `~/.kiro/steering/` für projektübergreifende Nutzung
+   - Oder nach `.kiro/steering/` für projektspezifische Nutzung
+
+2. **Manuelle Steering Files:**
+   - Referenziere mit `#dateiname` im Chat (z.B. `#onboarding-dokumentation`)
+
+3. **Prompts:**
+   - Kopiere in dein Projekt und referenziere mit `#dateiname`
+
+4. **Skills:**
+   - Kopiere den kompletten Skill-Ordner (z. B. `skills/pptx-infrago/`) nach
+     `~/.kiro/skills/<skill-name>/` für globale Verfügbarkeit
+   - Oder nach `<projekt>/.kiro/skills/<skill-name>/` für projektspezifische Nutzung
+   - Skills aktivieren sich automatisch über die Keywords im Frontmatter ihrer
+     `SKILL.md`, lassen sich aber auch explizit über den Skill-Namen ansprechen
+
+### Beispiele
+
+```
+# Onboarding-Dokumentation erstellen
+#onboarding-dokumentation
+Erstelle eine Onboarding-Dokumentation für dieses Projekt anhand des Plans.
+
+# Unit Tests schreiben
+#unit-tests-motivation
+Schreibe Unit Tests für die UserService Klasse nach diesem Leitfaden.
+
+# Codebase-Dokumentation generieren
+Erstelle eine AGENTS.md für dieses Projekt mit Fokus auf Architektur und Entwicklungspatterns.
+```
+
+### Von Steering zu Spec: Projektspezifische Dokumentation
+
+Die Steering-Dateien in diesem Repository sind generische Vorlagen. Für konkrete Projekte empfiehlt es sich, daraus eine **projektspezifische Spec** zu erstellen:
+
+**Warum eine Spec erstellen?**
+- Specs ermöglichen strukturierte, schrittweise Umsetzung komplexer Aufgaben
+- Fortschrittsverfolgung und Iterationen mit Feedback
+- Anpassung der generischen Vorlage an projektspezifische Anforderungen
+- Dokumentation des Prozesses und der Entscheidungen
+
+**Workflow:**
+
+1. **Steering-Datei als Basis nutzen:**
+   ```
+   #onboarding-dokumentation
+   Erstelle eine Spec für dieses Projekt basierend auf dieser Steering-Datei.
+   Passe die Tasks an die spezifischen Anforderungen dieses Projekts an.
+   ```
+
+2. **Kiro erstellt eine projektspezifische Spec:**
+   - Analysiert das aktuelle Projekt
+   - Passt die 7 Tasks an die Projektstruktur an
+   - Erstellt eine `.kiro/specs/onboarding-dokumentation.md` Datei
+   - Ermöglicht schrittweise Umsetzung mit Fortschrittsverfolgung
+
+3. **Spec ausführen:**
+   - Öffne die Spec-Datei in Kiro
+   - Arbeite Task für Task durch
+   - Kiro aktualisiert den Fortschritt automatisch
+   - Iteriere bei Bedarf einzelne Tasks
+
+**Beispiel-Prompt:**
+```
+#onboarding-dokumentation
+
+Analysiere dieses Projekt und erstelle eine projektspezifische Spec 
+für die Onboarding-Dokumentation. Berücksichtige dabei:
+- Die tatsächliche Projektstruktur und Technologien
+- Vorhandene Dokumentation, die erweitert werden soll
+- Spezifische Anforderungen unseres Teams
+
+Erstelle die Spec in .kiro/specs/onboarding-[projektname].md
+```
+
+## Beitragen
+
+Neue Prompts, Steering-Dateien und Skills sind willkommen. Bitte beachte:
+
+**Steering Files & Prompts:**
+- Steering-Dateien sollten Front-matter mit `inclusion: manual` oder `inclusion: auto` enthalten
+- Nutze Mermaid für Diagramme (kein PlantUML oder ASCII-Art)
+- Füge Nutzungshinweise und Beispiele hinzu
+- Dokumentiere Constraints klar und eindeutig
+
+**Skills:**
+- Folge der [Agent Skills Specification](https://agentskills.io/specification): `SKILL.md`
+  mit Frontmatter (`name`, `description`, ggf. `compatibility`/`metadata`)
+- Skill ist self-contained — alle Assets und Code-Module unter `assets/`,
+  zusätzliche Referenzen unter `references/`
+- Eigene `README.md` im Skill-Ordner mit Struktur, Voraussetzungen und Mini-Beispiel
+- Keine Build-Artefakte (`__pycache__/`, `*.pyc`) committen — siehe `.gitignore`
+
+## Lizenz
+
+Siehe [LICENSE](LICENSE) Datei für Details.