breadcrumb-the-shire/docs/reference-codex-prompts.md

# Codex Prompt-Standards

Letzte Aktualisierung: 2026-03-09

## Ziel

Wiederverwendbare Prompt-Muster für 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.
4. Vor Implementierungsstart die Vorbedingungen aus `/docs/reference-extension-readiness.md` prüfen.