refactor: Präzisiere plan-review-Ausgaben für bessere Klarheit #8

Merged
martin merged 1 commits from refactor/plan-review-clarity into main 2026-04-19 16:48:28 +02:00
Owner

Änderungen

  • skills/plan-review/SKILL.md: Verbesserte Begriffe im Ausgabeformat für Risiken und Blocker
  • skills/story/references/phase-3-plan-review.md: Konsistente Anpassung der Dokumentation

Beschreibung

Präzisiert die plan-review-Ausgabeformat um klarere Begriffe und Erwartungen:

  • Risiko: Verdeutlicht, dass es sich nicht um einen Blocker handelt, sondern um etwas, das bewusst abgewogen werden muss
  • Blocker: Fokussiert auf echte Showstopper (fehlende Migration, fehlend Auth-Konzept, fehlende Akzeptanzkriterien), nicht auf spekulative Tests

Dies reduziert Falsch-Positive in Plan-Reviews und macht die Feedback-Qualität klarer.

Akzeptanzkriterien

  • plan-review-Ausgabe zeigt korrekte Begriffe ("Risiko", "Blocker" statt "Fehlt")
  • Dokumentation ist konsistent zwischen SKILL.md und Referenz-Dateien
  • Reduziert Verwirrung über was ein echter Blocker vs. eine Empfehlung ist
## Änderungen - `skills/plan-review/SKILL.md`: Verbesserte Begriffe im Ausgabeformat für Risiken und Blocker - `skills/story/references/phase-3-plan-review.md`: Konsistente Anpassung der Dokumentation ## Beschreibung Präzisiert die plan-review-Ausgabeformat um klarere Begriffe und Erwartungen: - **Risiko**: Verdeutlicht, dass es sich nicht um einen Blocker handelt, sondern um etwas, das bewusst abgewogen werden muss - **Blocker**: Fokussiert auf echte Showstopper (fehlende Migration, fehlend Auth-Konzept, fehlende Akzeptanzkriterien), nicht auf spekulative Tests Dies reduziert Falsch-Positive in Plan-Reviews und macht die Feedback-Qualität klarer. ## Akzeptanzkriterien - [ ] plan-review-Ausgabe zeigt korrekte Begriffe ("Risiko", "Blocker" statt "Fehlt") - [ ] Dokumentation ist konsistent zwischen SKILL.md und Referenz-Dateien - [ ] Reduziert Verwirrung über was ein echter Blocker vs. eine Empfehlung ist
martin added 1 commit 2026-04-19 16:48:21 +02:00
Verbessere die Begriffe in plan-review-Ausgabeformat:
- Risiko: verdeutliche dass dies kein Blocker ist, nur Abwägung
- Fehlt → Blocker: fokussiere auf echte Showstopper, nicht spekulative Tests

Dies macht Pläne klarer und reduziert Falsch-Positive in der Review.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
martin merged commit fb9d07950d into main 2026-04-19 16:48:28 +02:00
martin deleted branch refactor/plan-review-clarity 2026-04-19 16:48:28 +02:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: martin/claude-workflow#8