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

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

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: 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

Globale Steering Files:
- Kopiere Dateien nach ~/.kiro/steering/ für projektübergreifende Nutzung
- Oder nach .kiro/steering/ für projektspezifische Nutzung
Manuelle Steering Files:
- Referenziere mit #dateiname im Chat (z.B. #onboarding-dokumentation)
Prompts:
- Kopiere in dein Projekt und referenziere mit #dateiname
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:

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.

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
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: 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 Datei für Details.