# BestAiConfig

Du arbeitest mit einem KI-Assistenten. Zum Beispiel mit Claude Code,
Cursor, Cline oder GitHub Copilot. BestAiConfig gibt deinem Assistenten
feste Regeln und Fähigkeiten. Ein Befehl genügt. Danach arbeitet dein
Assistent wie ein erfahrenes Team.

Die Seite mit allen Dateien: <https://deltatree.github.io/BestAiConfig/>

## Was du bekommst

- Ein Regelwerk für alle Assistenten. Du pflegst es an einer Stelle.
- Über 90 Fähigkeiten, "Skills" genannt. Ein Skill ist eine Anleitung
  für eine Aufgabe. Zum Beispiel: Tests schreiben, eine Idee prüfen, eine
  Präsentation bauen.
- Einen Befehl, der eine Idee bis zum fertigen Produkt führt. Mehr dazu
  im [Cheat-Sheet](docs/cheat-sheet.md).

## So installierst du es

Du brauchst ein Projekt mit Git und ein Terminal.

1. Öffne ein Terminal im Hauptordner deines Projekts.
2. Führe diesen Befehl aus:

   ```sh
   curl -fsSL https://deltatree.github.io/BestAiConfig/bootstrap.sh | bash
   ```

3. Der Installer fragt, welche Assistenten du nutzt. Drücke Enter für
   alle. Oder tippe die Nummern, zum Beispiel `1 4`.
4. Der Installer fragt nach der Sprache. Drücke Enter für Deutsch.

Fertig. Dein Assistent liest die Regeln beim nächsten Start.

**Ohne Fragen installieren**, zum Beispiel in einem Skript:

```sh
curl -fsSL https://deltatree.github.io/BestAiConfig/bootstrap.sh | bash -s -- --yes
```

## Was der Installer tut

- Er holt alles in einem einzigen Download vom Webdienst. Das dauert
  wenige Sekunden.
- Er installiert keine Programme auf deinem Rechner. Kein Node.js, kein
  Homebrew, kein npm. Die BMAD-Skills baut der Webdienst vorab.
- Er lädt zuerst alles herunter. Erst dann ändert er dein Projekt.
- Er sichert deine Dateien vorher. Geht etwas schief, stellt er sie wieder her.
- Er schreibt nur in feste Ordner, zum Beispiel `.claude`, `.cursor`,
  `.clinerules`. Deinen Code fasst er nie an.
- Deine eigenen Dateien bleiben. Schreibe das Wort `local` in den
  Dateinamen, zum Beispiel `team.local.md`. Dann bleibt die Datei bei
  jeder neuen Installation erhalten.
- Du kannst den Befehl beliebig oft ausführen. Das Ergebnis ist immer gleich.

Die vollständige Liste aller Dateien steht auf der [Technik-Seite](docs/technik.md).

## Der eine Befehl: von der Idee bis zum Betrieb

Du hast eine Idee. Tippe in Claude Code:

```
/idea-to-production Nachbarn sollen sich Werkzeuge leihen können.
```

Dein Assistent führt die Idee durch alle Schritte: Idee, Plan,
Anforderungen, Bauen, Testen, Veröffentlichen, Betrieb. Du sagst Ja oder
änderst Vorschläge. Oder du sagst "komplett autonom". Dann arbeitet er
allein bis zum Ende.

Das geht für ein neues Produkt. Und für ein Produkt, das schon Code hat.
Bei bestehendem Code liest der Assistent zuerst den Bestand. Er ändert
nur, was zur Idee gehört.

Alle Schritte und Befehle stehen im [Cheat-Sheet](docs/cheat-sheet.md).

## Aktualisieren und entfernen

Aktualisieren: Führe den Install-Befehl noch einmal aus.

Eine feste Version installieren, zum Beispiel 1.5.0:

```sh
curl -fsSL https://deltatree.github.io/BestAiConfig/bootstrap.sh | bash -s -- --yes --version 1.5.0
```

Alles entfernen, was BestAiConfig installiert hat:

```sh
curl -fsSL https://deltatree.github.io/BestAiConfig/bootstrap.sh | bash -s -- --uninstall
```

Deine eigenen Dateien bleiben dabei erhalten.

## Wenn etwas nicht klappt

| Meldung | Was du tust |
|---|---|
| `curl is required` | Installiere das Programm `curl`. Auf dem Mac ist es schon da. |
| `another bootstrap run appears to be active` | Ein alter Lauf hat eine Sperre hinterlassen. Lösche den Ordner `.bootstrap.lock` im Projekt. |
| `bundle unavailable` | Der Webdienst war nicht erreichbar. Der Installer lädt dann Datei für Datei. Nur die BMAD-Skills fehlen. Starte die Installation später noch einmal. |
| `tool 'rtk' is not installed` | Nur ein Hinweis. `rtk` spart Tokens, ist aber optional. Die Meldung nennt den Befehl, wenn du es willst. |
| Der Assistent ignoriert die Regeln | Starte den Assistenten neu. Er liest die Regeln nur beim Start. |

## Mehr lesen

| Seite | Für wen |
|---|---|
| [Cheat-Sheet](docs/cheat-sheet.md) | Für alle. Der eine Befehl und alle Schritte auf einer Seite. |
| [Erweiterungen](docs/erweiterungen.md) | Für alle. Mehr Fähigkeiten nachrüsten, zum Beispiel Marketing oder Recht. |
| [Technik](docs/technik.md) | Für Entwickler. Alle Dateien, alle Optionen, wie es innen funktioniert. |
| [Betrieb](docs/operations.md) | Für die Person, die diese Seite betreibt. |
| [Sicherheit](SECURITY.md) | Was der Installer prüft und was nicht. |

## Tests ausführen

Für Entwickler, die am Projekt arbeiten. Der schnelle Lauf:

```sh
sh tests/smoke.sh
```

Der volle Lauf vor jedem Merge:

```sh
python3 -m unittest discover
```

Beide brauchen nur Python. Mehr dazu in [CONTRIBUTING.md](CONTRIBUTING.md).

## Lizenz und Herkunft

Der Code, der Installer und die eigenen Regeln stehen unter der
[MIT-Lizenz](LICENSE).

Die Dateien unter `sources/vendored/` sind kurze Zusammenfassungen von
Normen und fremden Werken. Zum Beispiel DIN 8581-1, DIN SPEC 33429 und
ASD-STE100. Jede Datei nennt ihre Quelle. Die MIT-Lizenz gilt für die
Zusammenfassung hier. Sie gilt nicht für die Normen selbst. Die Normen
gehören ihren Herausgebern.