Skip to content

Clarify: Zurückstellen an die Plan-Phase auf HOW-Fragen begrenzen - #11

Merged
GodModeAI2025 merged 2 commits into
mainfrom
learnings/2026-09-16
Sep 16, 2026
Merged

GodModeAI2025 merged 2 commits into
mainfrom
learnings/2026-09-16

Conversation

@GodModeAI2025

Copy link
Copy Markdown
Owner

Clarify hatte keine Regel dafür, wann eine Lücke an die Plan-Phase abgegeben werden darf. Damit konnte „klärt sich im Plan“ NFR-Zielwerte, Akzeptanzkriterien, Fehlerszenarien und Grenzfälle aus der Fragen-Queue drängen.

Änderungen (references/02-clarify.md)

  • Neuer Abschnitt „Zurückstellen an die Plan-Phase (eng begrenzt)“: Zurückgestellt werden darf nur Umsetzungsweg, Technologievergleich oder Task-Zerlegung, also das, was nach AP-01 ohnehin nicht in die Spec gehört. NFRs, Gherkin-ACs, Fehler-/Unwanted-Szenarien, Grenz- und Randzustände sowie Systemgrenzen bleiben in Clarify; bei erschöpftem Fragen-Budget gilt weiter die [Annahme: ...]-Regel.
  • Ausnahme (Review-Commit): HOW-Fragen mit Architektur- oder Schnittstellen-Impact (F4, z. B. Auth-Verfahren aus dem Beispiel SF-SEC-001) bleiben in Clarify und blockieren Gate G2. Ohne diese Ausnahme hätte die Regel dem bestehenden Beispiel widersprochen.
  • Gate G2: neuer Prüfpunkt. Stringenz-Regeln: Zeile „Zurückstellen begrenzt“.

Warum sinnvoll

Schließt einen real beobachteten Fehlermodus, ohne neue Mechanik: passt zur WHAT/HOW-Trennung (AP-01) und zur F-Stufen-Logik.

Inspiration

  • github/spec-kit #4507 „Bound speckit.clarify planning deferral to implementation details“ (MIT, gemergt 2026-09-15). Übernommen wurde nur die Idee, kein Text.

Prüfungen (vom Reviewer erneut ausgeführt)

  • alle scripts/check-*.py OK
  • python3 -m unittest discover -s tests: 65 Tests OK
  • python3 evals/run_static.py: 8 von 8 Fällen bestanden
  • package-skill.py + check-package.py: Paket vollständig

🤖 Generated with Claude Code

GodModeAI2025 and others added 2 commits September 16, 2026 21:55
Clarify kannte keine Regel dafuer, wann eine Luecke an die Plan-Phase
abgegeben werden darf. "Klaert sich im Plan" wurde so zum Sammelgrund,
NFR-Zielwerte, Akzeptanzkriterien, Fehlerszenarien und Grenzfaelle
aus der Fragen-Queue zu nehmen, obwohl genau sie ins WHAT der Spec
gehoeren.

Zurueckgestellt werden darf jetzt nur, was ohnehin HOW ist (AP-01):
Umsetzungsweg, Technologievergleich, Task-Zerlegung. Alles andere
bleibt offen oder wird bei erschoepftem Budget als [Annahme: ...]
markiert. Gate G2 und die Stringenz-Regeln pruefen das mit.

Anlass: github/spec-kit #4507 hat dieselbe Luecke in
/speckit.clarify geschlossen.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Das Frageformat-Beispiel SF-SEC-001 (Auth-Verfahren) ist ein Umsetzungsweg
mit Architektur-Impact. Ohne Ausnahme haette die neue Regel erlaubt, es an
Plan abzugeben, obwohl offene F4-Fragen Gate G2 blockieren.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@GodModeAI2025
GodModeAI2025 merged commit 0abb883 into main Sep 16, 2026
1 check passed
@GodModeAI2025
GodModeAI2025 deleted the learnings/2026-09-16 branch September 16, 2026 20:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant