fs
545bcc789b
Most German docs were written with `ue`/`ae`/`oe`/`ss` ASCII fallbacks (`fuer`, `aenderung`, `koennen`, `gemaess`) — relic from older toolchain constraints. Replaced 237 occurrences across 38 .md files with proper umlauts and ß so the docs read naturally. Substitutions are constrained to plain prose: fenced code blocks (```...```), inline code spans (`...`), markdown link targets `[..](..)`, and HTML comments are preserved verbatim. Path references like `docs/howto-erste-aenderung.md` keep their original (umlaut-replaced) filenames — only the surrounding prose is normalised. Tool: bin/fix-md-umlauts.py (idempotent — no-op on already-clean files). Re-runnable if ASCII fallbacks creep back in via copy-paste. Doc-link-check + doc-drift-check stay green. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
67 lines
1.8 KiB
Markdown
67 lines
1.8 KiB
Markdown
# 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.
|