forked from fa/breadcrumb-the-shire
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>
1.8 KiB
1.8 KiB
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)
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
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)
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:
- Keine impliziten Extension-Standards erfinden.
- Erweiterungen explizit als Out-of-Scope kennzeichnen.
- Nur dokumentieren, was bereits verbindlich im Repo festgelegt ist.
- Vor Implementierungsstart die Vorbedingungen aus
/docs/reference-extension-readiness.mdprüfen.