103 lines
5.5 KiB
Markdown
103 lines
5.5 KiB
Markdown
---
|
||
title: Sprint Change Proposal — Epic 3 Completion Remediation
|
||
status: approved
|
||
created: 2026-08-20
|
||
approved_by: ProMods
|
||
approval: "Explizite Chat-Freigabe: Ja"
|
||
classification: moderate
|
||
affected_epic: 3
|
||
---
|
||
|
||
# Sprint Change Proposal: Epic 3 belastbar abschließen
|
||
|
||
## 1. Issue Summary
|
||
|
||
Der unabhängige Read-only-Audit nach Story 3.8 zeigte, dass Epic 3 seine bereits zugesagten Anforderungen und Architekturverträge noch nicht als kohärenten System-Inkrement belegt. Betroffen sind insbesondere deterministische Relevanz und Routing, semantische Update-/Synthese-Erhaltung, Root-Scope-Leasing, transaktionaler Run-Abschluss, AD-17h-Reproduzierbarkeit und die ausführbare End-to-End-Abnahme.
|
||
|
||
Der Trigger ist kein neuer Produktwunsch, sondern eine fehlgeschlagene Verifikation bestehender Zusagen aus FR-4, FR-6, FR-7, FR-12, AD-5/6/13/17 und A0-6/7/12..19. Konkrete Evidenz liegt in `schema/compiler.md`, den Story-3-Sandboxes, `wiki/log.md`, dem Sprint-Status und `epic-3-context.md` vor.
|
||
|
||
## 2. Impact Analysis
|
||
|
||
### Epic Impact
|
||
|
||
- Epic 3 bleibt `in-progress`; Story 3.8 wird aus `review` nach `in-progress` zurückgenommen.
|
||
- Stories 3.9–3.13 werden innerhalb von Epic 3 ergänzt.
|
||
- Ein neues Epic ist nicht gerechtfertigt: Alle Arbeiten schließen bereits zugesagte Epic-3-Verträge.
|
||
- Epic 4 beginnt erst nach dem Story-3.13-Abnahmegate.
|
||
|
||
### Scope Boundary zu Epic 4
|
||
|
||
Epic 3 erkennt klassifikationspflichtige Kollisionen und Widersprüche und hält fail-closed an; dies ist seine Sicherheitsgrenze aus AD-17c/A0-14. Vollständige AD-16-Klassifikation, semantische Kollisionsauflösung (AD-17c/g) und Disagreement-Dokumentation verbleiben in Epic 4. A0-21 ist geteilt: Story 3.10 belegt die Erhaltung unabhängigen Wissens, Story 4.3 das Human-Curation-Verhalten/FT-9. Damit entfällt die bisherige zyklische Behauptung, Epic 3 sei abgeschlossen, obwohl sein Merge-/Resolution-Pfad Epic 4 voraussetzt.
|
||
|
||
### Artifact Impact
|
||
|
||
- PRD: keine Änderung.
|
||
- Architecture Spine: keine Änderung; die Story-Zuordnung wird mit den bestehenden Entscheidungen konsistent gemacht.
|
||
- `epics.md`: Scope-Korrektur, Story-3.8-Präzisierung und Stories 3.9–3.13.
|
||
- `sprint-status.yaml`: Story 3.8 `in-progress`, neue Stories `backlog`.
|
||
- `epic-3-context.md`: Story-Liste, technische Grenzen und Abhängigkeiten synchronisiert.
|
||
- Code, Compiler-Instruktion, Tests und Knowledge Bundle werden durch diese Planungskorrektur nicht verändert.
|
||
|
||
## 3. Recommended Approach
|
||
|
||
**Gewählt: Direct Adjustment innerhalb von Epic 3.**
|
||
|
||
Rollback bereits abgeschlossener Stories würde die vorhandene Arbeit nicht vereinfachen. Eine PRD-/MVP-Neudefinition ist ebenfalls nicht nötig. Die kleinste kohärente Korrektur ist, die offenen systemischen Verantwortungen in klar geschnittene Remediation-Stories zu überführen, Story 3.8 ehrlich wieder zu öffnen und ein finales ausführbares Abnahmegate einzuführen.
|
||
|
||
Aufwand: mittel bis hoch. Risiko: mittel bei Umsetzung vor Epic 4; hoch, falls Epic 4 auf dem derzeit unzuverlässigen Lease-/Log-/Compiler-Unterbau beginnt.
|
||
|
||
## 4. Detailed Change Proposals
|
||
|
||
### Bestehende Story
|
||
|
||
- **Story 3.8 — Determinismus-Vertrag:** wieder öffnen; zwei getrennte Worktrees und frische Agent-Kontexte, kanonisches Eingabemanifest, rekonstruierbarer Run-Receipt, keine hart codierten Outputs und keine pauschale Maskierung von Trust-Ereignissen.
|
||
|
||
### Neue Stories
|
||
|
||
1. **Story 3.9 — Deterministische Relevanz- und Reconcile-Routing schließen**
|
||
|
||
Schließt Termgewinnung, symmetrische Normalisierung, literal-sichere Suche, exklusive Routing-Tabelle, Raw-Immutability-Guard und reservierte Zielpfade.
|
||
|
||
2. **Story 3.10 — Inkrementelle Update- und Synthese-Erhaltung absichern**
|
||
|
||
Beweist In-place-Update, Erhaltung vorhandenen Wissens, vollständige Multi-Evidenz-Provenienz, echten No-op und kohärente Synthese ohne historische Hardcodings.
|
||
|
||
3. **Story 3.11 — Root-Scope-Leasing atomar und worktree-übergreifend akquirieren**
|
||
|
||
Realisiert einen scope-bezogenen atomaren Lock und echte konkurrierende Worktree-Tests für unterschiedliche Run-IDs.
|
||
|
||
4. **Story 3.12 — Lease-Lifecycle und Commit-Abschluss transaktional schließen**
|
||
|
||
Schließt Staleness/Liveness, Dirty-Tree-Schutz, Baseline-Rollback, durable Release, Clean-Next-Run und die Grenze des kanonischen Knowledge Logs.
|
||
|
||
5. **Story 3.13 — Epic-3-Verifikations- und Abnahmegate**
|
||
|
||
Führt portable fail-fast Verifikation, vollständigen OKF-Validator, einen realen Agent-Instruktionslauf, unabhängige Reproduktion und einen Epic-5-Abhängigkeits-Smoke-Test zusammen.
|
||
|
||
### Reihenfolge
|
||
|
||
```text
|
||
3.9 → 3.10 ┐
|
||
├→ 3.8 Abschluss → 3.13 Abnahme → Epic 4
|
||
3.11 → 3.12┘
|
||
```
|
||
|
||
## 5. Implementation Handoff
|
||
|
||
**Klassifikation:** Moderate Backlog-Reorganisation, anschließend Developer-/Review-Ausführung.
|
||
|
||
- Product Owner: bestätigt Story-Schnitt und Scope-Grenze — erfolgt am 2026-08-20.
|
||
- Developer: implementiert Stories in der angegebenen Abhängigkeitsreihenfolge.
|
||
- Reviewer: prüft jede Story gegen ihre ausführbaren Negativ- und Positivbelege; Story 3.13 ist die Epic-Abnahme.
|
||
- Epic 3 wird erst `done`, wenn Story 3.8 und Stories 3.9–3.13 `done` sind und das Story-3.13-Gate erfolgreich ist.
|
||
|
||
## 6. Checklist Record
|
||
|
||
- [x] Trigger und konkrete Audit-Evidenz verstanden
|
||
- [x] Auswirkungen auf Epic 3, Epic 4 und Epic 5 geprüft
|
||
- [x] PRD-/Architecture-Konflikte geprüft; keine Änderung erforderlich
|
||
- [x] Direct Adjustment gegen Rollback und MVP-Neuschnitt bewertet
|
||
- [x] Story-Schnitt, Reihenfolge und Handoff festgelegt
|
||
- [x] Explizite Nutzerfreigabe erhalten
|
||
- [x] Sprint-Status und Epic-Kontext synchronisiert
|