# Powers

Dieser Ordner enthält **Kiro Powers**: gebündeltes Dokumentations-/Workflow-Wissen,
das Kiro bei passenden Anfragen automatisch aktiviert.

> Was ist eine Power? Eine Power verpackt Wissen (`POWER.md`), optionale
> Workflow-Guides (`steering/*.md`) und optional MCP-Server. Kiro lädt die
> Detail-Instruktionen erst bei Bedarf („on-demand") — das hält den Kontext schlank.

## Enthaltene Powers

| Power | Zweck | Aktiviert bei Themen wie |
|-------|-------|--------------------------|
| [`db-openshift-deploy`](db-openshift-deploy/) | Manuelles Deployment: Docker → Artifactory → OpenShift (`oc`) | openshift, oc, dbcs, artifactory, image pull |
| [`db-pipeship-onboarding`](db-pipeship-onboarding/) | Repo mit pipeship aufsetzen (CI/CD bis Prod, K8s, Trivy, Renovate) | pipeship, gitlab ci, deploy_k8s_generic, cdaas |
| [`db-dxp-platform`](db-dxp-platform/) | Nachschlagewerk DXP-Ökosystem (pipeship, CDaaS, Portal, Compliance) | dxp, developer portal, crossplane, flux, tenant |
| [`db-scm-info-compliance`](db-scm-info-compliance/) | `scm-info.yaml` erstellen/validieren + Compliance-Checks | scm-info, compliance suite, beam id, sbom |

Jede Power liegt in einem eigenen Ordner mit einer `POWER.md` (Pflicht); manche
haben zusätzlich `steering/`-Dateien für vertiefende Workflows.

```
powers/
├── README.md                       # diese Datei
├── db-openshift-deploy/
│   └── POWER.md
├── db-pipeship-onboarding/
│   ├── POWER.md
│   └── steering/
│       └── repo-typen.md
├── db-dxp-platform/
│   └── POWER.md
└── db-scm-info-compliance/
    └── POWER.md
```

## Installation (lokal testen)

Powers werden über die **Powers-UI** in Kiro installiert:

1. **Powers-Panel öffnen**: Powers-Icon in der Kiro-Sidebar — oder Command Palette →
   *„Powers"* — oder Kiro bitten: „Open the powers configuration".
2. **„Add Custom Power"** klicken.
3. **„Local Directory"** wählen.
4. **Absoluten Pfad** zum gewünschten Power-Ordner einfügen, z. B.:
   ```
   <PFAD-ZUM-REPO>/powers/db-pipeship-onboarding
   ```
   (Pro Power einmal — der Pfad zeigt auf den Ordner, der die `POWER.md` enthält.)
5. **„Add"** klicken. Die Power erscheint unter *Installed Powers* (Status „Active").

> **Wichtig:** Der Pfad muss **auf den einzelnen Power-Ordner** zeigen (mit `POWER.md`
> direkt darin), **nicht** auf `powers/`.

## Teamweite Verteilung

Da dieses Repo ein Git-Repo ist, können die Powers auch als **Repository-Quelle** in
Kiro hinterlegt werden — dann installiert das Team sie direkt aus Git statt über lokale
Pfade. In der Powers-UI eine Custom-Repository-Quelle mit der Repo-URL und dem Pfad
`powers/<power-name>` hinzufügen.

## Eigene Power hinzufügen

1. Neuen Ordner `powers/<name>/` anlegen.
2. `POWER.md` mit Frontmatter (Name, Beschreibung, Keywords) + Inhalt erstellen.
3. Optional `steering/*.md` für vertiefende Workflows ergänzen.
4. Diese Tabelle oben aktualisieren, committen, pushen.

Mehr zum Bauen eigener Powers: https://kiro.dev/docs/powers/ — sowie die offizielle
Power **„Build a Power"** (`power-builder`) in der Kiro-Powers-Registry.