Lars
b747200f3a
All checks were successful
Deploy Development / deploy (push) Successful in 46s
Test Suite / pytest-backend (push) Successful in 4m13s
Test Suite / lint-backend (push) Successful in 3s
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 12s
Methodenuebergreifende Provider auf Kernel v0.3; verbindliche Coding Rules fuer Agenten in ADP und .cursor/rules. Co-authored-by: Cursor <cursoragent@cursor.com>
63 lines
2.6 KiB
Plaintext
63 lines
2.6 KiB
Plaintext
---
|
|
description: Steering Kernel v0.3 — verbindliche Regeln für Read Models, Proposals, Attention, Ranker (alle Coding-Agenten)
|
|
globs: backend/steering/**,backend/data_layer/initiative_snapshot.py,frontend/src/components/SteeringProposalsPanel.jsx,frontend/src/components/SprintCommitProposalPanel.jsx,frontend/src/utils/steeringProposals.js,frontend/src/utils/sprintCommitProposal.js,frontend/src/pages/initiative/InitiativeInboxPage.jsx,frontend/src/pages/initiative/InitiativePlanPage.jsx,frontend/src/pages/modes/PlanSprintPage.jsx
|
|
alwaysApply: true
|
|
---
|
|
|
|
# Kairo Steering Kernel — Coding Rules (verbindlich)
|
|
|
|
**Primärdokument:** `docs/architecture/ADP_Steering_Kernel_Coding_Rules_v0.1.md`
|
|
**Architektur:** `docs/architecture/ADP_Steering_Kernel_Extension_Model_v0.1.md`
|
|
|
|
## Herzmaschine
|
|
|
|
- Initiative-Steuerung **nur** via `evaluate_steering()` in `backend/steering/kernel/evaluate.py`
|
|
- Snapshot spiegelt `evaluation.read_models` + `evaluation.proposals` — **kein** Duplikat-Rechnen
|
|
|
|
## Neue Fähigkeit = Provider registrieren
|
|
|
|
| Was | Wo |
|
|
|-----|-----|
|
|
| Read Model | `steering/read_models/registry.py` |
|
|
| Proposal | `steering/proposals/registry.py` |
|
|
| Attention | `steering/attention/contributors/*.py` + Registry |
|
|
| Sprint-Ranker | `register_sprint_commit_ranker()` — weitere Ranker analog |
|
|
|
|
Aktivierung über `steering_elements` / `data_slices` im Methoden-Vertrag — **nicht** über Page-Ifs oder `method_key`-Branches im Kernel.
|
|
|
|
## Proposals
|
|
|
|
- **Kein Auto-Commit** — Accept in UI/API
|
|
- **Keine feste Bug/Story-Policy** — `ranker_key` + `factors[]`; Heuristik = Fallback (`heuristic_v0`)
|
|
- Abhängigkeiten: `dependency_refs`, `dependency_blocked`
|
|
- KI: `agent_v1` Ranker + Actor-Slot — **keine** hardcodierten Prompts (Principle Gate)
|
|
|
|
## Frontend
|
|
|
|
- `SteeringProposalsPanel` + `PROPOSAL_UI_CONFIG` in `utils/steeringProposals.js`
|
|
- Daten aus `steeringSnapshot.steering_kernel.proposals`
|
|
- Keine neue Proposal-Page pro Methode
|
|
|
|
## Methoden-Parität (Ist)
|
|
|
|
| Provider | Element-Gate |
|
|
|----------|--------------|
|
|
| `sprint_commit` | `work_cycle_scope` |
|
|
| `gate_next_actions` | `gate_fulfillment` |
|
|
| `intake_triage` | `backlog` slice, **excludes** `work_cycle_scope` |
|
|
| `epic_rollup` | `backlog_epic_hierarchy` |
|
|
| `planning_debt` / `execution_graph` | `gate_fulfillment` / `critical_path` |
|
|
|
|
## Verboten
|
|
|
|
- Steuerungslogik außerhalb `backend/steering/`
|
|
- Archetyp-Ifs für Steuerungs-UI
|
|
- `evaluate_next_work` für Commit-Vorschläge (Plan ≠ Ist)
|
|
- OM-Tabellen für Vorschläge
|
|
|
|
## Tests
|
|
|
|
- Unit-Test pro Provider/Ranker
|
|
- Snapshot-Integration wenn DB-Test verfügbar
|
|
- Truth Table aktualisieren
|