Kristian
98 lines
3.7 KiB
Markdown
98 lines
3.7 KiB
Markdown
---
|
||
name: plan-start
|
||
description: Legt in einem neuen oder leeren Projektordner die standardisierte Dokumentations- und Wegweiser-Struktur an (CLAUDE.md, docs/ mit 00-overview, 10-plan, 20-architecture, 90-status, 30-decisions/, 40-workflows/, sessions/). Nutzt die Templates unter templates/ dieses Skills. Soll nur auf explizite Nutzeranforderung laufen, nie autonom.
|
||
disable-model-invocation: true
|
||
argument-hint: "<kurzer projekttitel oder eine zeile zur idee>"
|
||
allowed-tools:
|
||
- Read
|
||
- Write
|
||
- Edit
|
||
- Bash
|
||
---
|
||
|
||
# plan-start — Projekt-Scaffolding
|
||
|
||
## Wann der Skill läuft
|
||
|
||
Ausschließlich auf expliziten Aufruf, in einem **neuen oder noch leeren
|
||
Projektordner**. Der Skill legt eine Grundstruktur an und darf vorhandene
|
||
Dateien nicht überschreiben.
|
||
|
||
## Was der Skill tut
|
||
|
||
1. Prüft den aktuellen Arbeitsordner. Wenn dort bereits `CLAUDE.md` oder
|
||
`docs/` existiert → **abbrechen** und dem Nutzer melden: „Hier liegt schon
|
||
ein initialisiertes Projekt. `plan-start` ist idempotent nicht — du willst
|
||
vermutlich `status` oder direkt in `docs/` editieren."
|
||
2. Stellt dem Nutzer vor dem Schreiben **kurz und konkret** diese Fragen
|
||
(eine nach der anderen, nicht als Sammel-Liste):
|
||
- **Projektname** (wird als Titel in CLAUDE.md und Headings verwendet)
|
||
- **Ein-Satz-Zweck** („Wofür ist das Projekt da?")
|
||
- **Aktuelle Phase** (Planung / Build / Wartung — Default: Planung)
|
||
- **Stack in Stichworten** (z. B. „Python + FastAPI + PocketBase",
|
||
„NixOS + Caddy + Docker Compose" — darf auch leer sein, wenn noch unklar)
|
||
3. Legt folgende Struktur an — relativ zum aktuellen Arbeitsordner:
|
||
|
||
```
|
||
./CLAUDE.md
|
||
./.claude/skills/.gitkeep
|
||
./docs/00-overview.md
|
||
./docs/10-plan.md
|
||
./docs/20-architecture.md
|
||
./docs/90-status.md
|
||
./docs/30-decisions/README.md
|
||
./docs/40-workflows/README.md
|
||
./docs/sessions/README.md
|
||
```
|
||
|
||
4. Befüllt jede Datei aus dem passenden Template unter
|
||
`./templates/` dieses Skills. Platzhalter werden wie folgt ersetzt:
|
||
|
||
| Platzhalter | Quelle |
|
||
|---|---|
|
||
| `{{PROJECT_NAME}}` | aus Frage 1 |
|
||
| `{{PROJECT_PURPOSE}}` | aus Frage 2 |
|
||
| `{{PROJECT_PHASE}}` | aus Frage 3 |
|
||
| `{{PROJECT_STACK}}` | aus Frage 4, leer → `TBD` |
|
||
| `{{TODAY_ISO}}` | heutiges Datum als `YYYY-MM-DD` via `date +%F` |
|
||
| `{{USER_NAME}}` | optional: `git config user.name`, sonst leer |
|
||
|
||
5. Erzeugt `.claude/skills/.gitkeep` als leere Datei, damit das
|
||
projektspezifische Skill-Verzeichnis unter Versionskontrolle bleibt, auch
|
||
solange es leer ist.
|
||
|
||
6. Gibt am Ende eine **kurze Bestandsaufnahme** in 3–5 Zeilen aus: was wurde
|
||
angelegt, was als Nächstes sinnvoll ist (Empfehlung: `docs/00-overview.md`
|
||
und `docs/10-plan.md` durchgehen und konkretisieren, dann `handoff`).
|
||
|
||
## Harte Regeln
|
||
|
||
- **Nie** Dateien überschreiben. Wenn auch nur eine der Zieldateien existiert:
|
||
komplett abbrechen und den Nutzer informieren.
|
||
- **Nie** in ein nicht-leeres Git-Repo schreiben, ohne vorher zu warnen. Ein
|
||
Repo mit einer `.git/`, aber ohne `CLAUDE.md` und ohne `docs/` ist in Ordnung
|
||
— das heißt der Nutzer hat bereits `git init` gemacht, das ist der Normalfall.
|
||
- **Nie** `git commit` selbstständig ausführen. Der Nutzer entscheidet, was
|
||
committet wird.
|
||
|
||
## Tonfall in den erzeugten Templates
|
||
|
||
- Prosa auf Deutsch, kurz, konkret.
|
||
- Code, Pfade, Kommandos auf Englisch.
|
||
- Platzhalter-Abschnitte sind mit `TBD` oder einem sichtbaren HTML-Kommentar
|
||
`<!-- TODO: ... -->` markiert, damit der Nutzer sofort sieht, was noch gefüllt
|
||
werden muss.
|
||
|
||
## Templates
|
||
|
||
Siehe `./templates/` im Skill-Ordner:
|
||
|
||
- `CLAUDE.md.tmpl`
|
||
- `00-overview.md.tmpl`
|
||
- `10-plan.md.tmpl`
|
||
- `20-architecture.md.tmpl`
|
||
- `90-status.md.tmpl`
|
||
- `30-decisions.README.md.tmpl`
|
||
- `40-workflows.README.md.tmpl`
|
||
- `sessions.README.md.tmpl`
|