docs: restructure docs to diataxis and finalize DOCS-RESTRUCTURE-001
This commit is contained in:
65
docs/reference-codex-prompts.md
Normal file
65
docs/reference-codex-prompts.md
Normal file
@@ -0,0 +1,65 @@
|
||||
# Codex Prompt-Standards
|
||||
|
||||
Letzte Aktualisierung: 2026-03-06
|
||||
|
||||
## Ziel
|
||||
|
||||
Wiederverwendbare Prompt-Muster fuer konsistente Planung und Implementierung mit den Skills `core-guardrails` und `starterkit-planner`.
|
||||
|
||||
## Prompt: Implementierung (strict)
|
||||
|
||||
```text
|
||||
Nutze die Skills core-guardrails und starterkit-planner.
|
||||
|
||||
Implementiere folgende Aufgabe strikt nach den Starterkit-Guardrails:
|
||||
<aufgabe>
|
||||
|
||||
Pflicht:
|
||||
1) Schichtgrenzen, Input/Validation, RBAC/UI-Contracts einhalten.
|
||||
2) Minimalen Scope aendern, keine impliziten Nebenwirkungen.
|
||||
3) Relevante Quality Gates ausfuehren und Ergebnis berichten.
|
||||
4) Bei Regelkonflikt klar als Blocker markieren statt Workaround.
|
||||
```
|
||||
|
||||
## Prompt: Refactor / Zentralisierung
|
||||
|
||||
```text
|
||||
Nutze die Skills core-guardrails und starterkit-planner.
|
||||
|
||||
Ziel: Duplikate reduzieren und Standards zentralisieren, ohne Verhalten zu brechen.
|
||||
Aufgabe:
|
||||
<aufgabe>
|
||||
|
||||
Liefere:
|
||||
1) Entscheidungsmatrix (Optionen + Tradeoffs)
|
||||
2) Gewaehlten Ansatz mit Begruendung
|
||||
3) Decision-complete Umsetzungsplan
|
||||
4) Test- und Migrationsabsicherung
|
||||
```
|
||||
|
||||
## Prompt: Architekturplan (decision complete)
|
||||
|
||||
```text
|
||||
Nutze die Skills core-guardrails und starterkit-planner.
|
||||
|
||||
Erstelle einen decision-complete Plan fuer:
|
||||
<vorhaben>
|
||||
|
||||
Format ist verpflichtend:
|
||||
1) Ziel + Success Criteria
|
||||
2) In/Out-of-Scope
|
||||
3) Oeffentliche Interfaces / Contracts
|
||||
4) Implementierungsschritte
|
||||
5) Tests / Abnahme
|
||||
6) Risiken / Migration
|
||||
7) Annahmen / Defaults
|
||||
```
|
||||
|
||||
## Out of Scope: Extensions
|
||||
|
||||
Die Extension-Mechanik (Ablage, Hooks, Lifecycle) ist aktuell nicht standardisiert.
|
||||
|
||||
Regel:
|
||||
1. Keine impliziten Extension-Standards erfinden.
|
||||
2. Erweiterungen explizit als Out-of-Scope kennzeichnen.
|
||||
3. Nur dokumentieren, was bereits verbindlich im Repo festgelegt ist.
|
||||
Reference in New Issue
Block a user