refactor(steering): Sprint-Vorschlaege mit austauschbarem Ranker und Abhaengigkeiten
Deploy Development / deploy (push) Successful in 46s
Test Suite / pytest-backend (push) Successful in 4m8s
Test Suite / lint-backend (push) Successful in 2s
Test Suite / compose-smoke (push) Has been skipped
Test Suite / k6 /api/health Baseline (push) Successful in 19s
Test Suite / playwright-smoke (push) Successful in 13s

Keine feste Bug-zuerst-Policy: heuristic_v0 als Fallback, agent_v1-Slot vorbereitet, parent_action-Abhaengigkeiten und factors[] fuer spaetere KI-Steuerung.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
LarsandCursor committed 2026-07-27 11:38:22 +02:00
1 parent 20636f88d2
commit 1bbc5dbfce
13 files changed
+524 -134

No files matched your search

@@ -49,15 +49,22 @@ Kein Phase-Sprung. **KI/Prompt/MCP** für P8 erst nach Principle Gate und stabil
## 4. P6 — Sprint-Vorschlag (Skizze)
**Read Model** `sprint_planning_proposal` (kein Pflicht-Commit):
**Read Model** `sprint_commit` (kein Pflicht-Commit):
- Input: offene Backlog-Items (Epic-Subbaum optional), aktiver/geplanter Sprint, Action-Ist, Blocker
- Output: ranked Liste `{ backlog_item_id, reason_code, score_hint }`
- Attention wenn: Sprint startet in N Tagen und Commit leer; Bugs ohne Owner; Epic intake_only trotz aktivem Sprint
- Input: committable Backlog-Items, Sprint-Horizont, Action-Ist, **Abhängigkeiten** (`parent_action_id`, Epic-Roll-up)
- Output: ranked Liste mit `ranker_key`, `factors[]`, `dependency_refs`, `dependency_blocked`
- **Keine feste Bug-Policy** — Default-Ranker `heuristic_v0` ist expliziter Fallback; Produktentscheidung später via `agent_v1` (Actor/KI, Principle Gate)
**UI:** Plan → Sprint — „Vorgeschlagene Items“ (Accept/Adjust), nicht Auto-Commit.
**Ranker-Auswahl** (Operating Context / Governance, nicht Page-If):
**Steuerung:** `evaluate_next_work` / eigene Strategy-Hook — **keine** Page-Ifs.
| Ranker | Status | Verhalten |
|--------|--------|-----------|
| `heuristic_v0` | ✓ Fallback | Priorität + Eingang + leichte kind_bias + Abhängigkeiten |
| `agent_v1` | Stub | Agent-Slot — wählt Subset/Begründung; bis Freigabe Fallback |
**UI:** Plan → Sprint — Vorschläge Accept/Adjust; blockierte Abhängigkeiten nicht committierbar.
**Steuerung:** `ProposalProvider` + austauschbarer Ranker — **nicht** `evaluate_next_work`, **keine** hardcodierte Sortierung in UI.
---
@@ -138,14 +138,20 @@ class ProposalProvider:
"scope_type": "backlog_item" | "action" | "roadmap_item" | "review",
"scope_id": "...",
"rank": 1,
"reason_code": "bug_in_active_sprint",
"summary": "Bug X — hohe Priorität, Sprint aktiv",
"confidence": "heuristic" | "rule" | "agent", # später
"score": 127.5,
"reason_code": "priority_critical",
"summary": "...",
"ranker_key": "heuristic_v0" | "agent_v1",
"confidence": "heuristic" | "agent",
"factors": [{"code": "priority", "weight": 100, "label": "..."}],
"dependency_refs": [{"ref_type": "parent_action", "ref_id": "...", "status": "..."}],
"dependency_blocked": false,
"data_source": "steering_kernel",
}
```
- UI: Accept / Adjust / Ignore — Mensch oder Agent bestätigt
- **Kein** festes „Bugs zuerst“ — Ranker austauschbar via `proposal_rankers.sprint_commit` im Operating Context / Governance
- **Agile P6:** `sprint_commit` ProposalProvider
- **Gate-Methoden:** `gate_next_actions` (planning_debt → konkrete AP-Vorschläge)
- **Continuous Product:** `intake_triage` (Eingang priorisieren)