Skip to content

Commit 9531a5a

Browse files
committed
feat(rpi): integrate Dexter Horthy's RPI framework findings without truncating files
Co-Authored-By: Craft Agent <agents-noreply@craft.do> - Introduce 'Research Summary' as mandatory section in plan.md - Introduce 'Outline' alignment before writing plan.md - Ensure iterative loop (Back-and-Forth) in Clarify/Plan phases - Add Plan Fidelity Check (F3) to review and Gate G5 - Enable 'Isolated Research' (Discover without feature-ticket bias) - Apply Prompt-Diet via Execution Rules to enforce step-by-step processing without truncating content
1 parent da10060 commit 9531a5a

6 files changed

Lines changed: 32 additions & 0 deletions

File tree

references/01-specify.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,11 @@
22

33
**Trigger:** Feature, Problem, Idee oder Prozess wird beschrieben.
44

5+
**Prompt Diet & Execution Rules (RPI Framework):**
6+
- Führe diesen Modus NIEMALS als einen einzigen großen Schritt aus.
7+
- Gehe strikt sequenziell vor: Lade Phase 0/1a, stoppe und frage den Nutzer. Erst nach Freigabe gehst du zu Phase 1b über (Back-and-Forth).
8+
- Max. 40 aktive Instruktionen pro Interaktion!
9+
510
---
611

712
## Phase 0: Komplexitätseinschätzung (optional, empfohlen bei neuen Produkten)

references/02-clarify.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,10 @@
55

66
**Trigger:** spec.md existiert, offene Fragen oder unterspezifizierte Bereiche vorhanden.
77

8+
**Prompt Diet & Execution Rules (RPI Framework):**
9+
- **Iterativer Loop:** Research und Plan sind nicht linear. Wenn dir im Planungs- oder Klärungsprozess Systemwissen fehlt, stoppe sofort. Kehre in die Recherche zurück, lies den Code, und setze erst danach fort.
10+
- Arbeite in kleinen Schritten (Back-and-Forth) mit dem Nutzer. Max. 40 Instruktionen auf einmal verarbeiten!
11+
812
---
913

1014
## Wann Pflicht vs. Optional (profilabhängig)

references/03-plan.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,11 @@
22

33
**Trigger:** spec.md existiert und Clarify ist abgeschlossen (oder bewusst übersprungen).
44

5+
**Prompt Diet & Execution Rules (RPI Framework):**
6+
- **Outline First:** Bevor du die detaillierte `plan.md` schreibst, präsentiere dem Nutzer zwingend eine High-Level Outline und kläre offene Fragen (Back-and-Forth).
7+
- **Iterativer Loop:** Fehlt dir Kontext? Stoppe die Planung und wechsle zurück in die Code-Recherche (Modus 9). Rate niemals Code-Strukturen!
8+
- Max. 40 Instruktionen pro Schritt.
9+
510
---
611

712
## Profil-Steuerung
@@ -58,6 +63,8 @@
5863
## Phase 3a: Plan
5964

6065
Erzeugt `plan.md` mit:
66+
67+
**WICHTIG (RPI-Framework):** Jeder Plan MUSS zwingend mit der Sektion `## 0. Research Summary & Context` beginnen. Fasse hier objektiv zusammen, was du in der Codebasis gelesen hast, BEVOR du Implementierungsschritte vorschlägst.
6168
- Technische Architekturentscheidungen → ADR in `specs/decisions/`
6269
- **Technisches Datenmodell** (WIE — abgeleitet vom fachlichen Modell in spec.md):
6370
- Persistenz-Strategie (RDBMS, Document Store, Event Store)

references/07-review.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,10 @@
33
**Trigger:** Bestehende Requirements, Specs oder Stories als Input.
44
**Methode:** 3-Ebenen-Prüfkatalog mit deterministischer Schweregrad-Zuordnung.
55

6+
**Prompt Diet & Execution Rules (RPI Framework):**
7+
- Gehe strikt Phase für Phase vor. Präsentiere Zwischenergebnisse, bevor du den kompletten Review abschließt.
8+
- Max. 40 Instruktionen auf einmal verarbeiten.
9+
610
## Profil-Steuerung
711

812
- **KRITIS:** Alle 3 Ebenen Pflicht; STRIDE vollständig (alle 6 Kategorien); GP-Score ≥ 9/10; Keine offenen BLOCKER/MAJOR erlaubt
@@ -40,6 +44,12 @@ Jede Ebene wird vollständig durchlaufen. Keine Ebene darf übersprungen werden,
4044

4145
#### Story-Quality-Score (SQS) — numerische Qualitätsbewertung
4246

47+
#### Ebene 1.5 — Plan Fidelity Check (Bei Code-Review)
48+
49+
Wenn Code *nach* einem Plan (z.B. `plan.md`) implementiert wurde, vergleiche den generierten Code zwingend mit dem Plan.
50+
- Jede Datei/Logik, die geändert wurde, aber *nicht* im Plan stand, ist "Drift" (eigenmächtiges Handeln).
51+
- **Schweregrad bei Drift:** Zwingend **F3 (CONDITIONAL)**. Erfordert explizite Risiko-Akzeptanz vom Nutzer.
52+
4353
Zusätzlich zur binären Prüfung (bestanden/nicht bestanden) erzeugt der Review einen numerischen **Story-Quality-Score (SQS)** pro Story. Der SQS misst *Formulierungsqualität*, nicht Governance-Compliance (das ist der GP-Score).
4454

4555
| Dimension | Gewichtung | 0 Punkte | 2.5 Punkte | 5 Punkte |

references/09-discover.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,11 @@
33
**Methode:** Reverse Engineering + Domain Analysis.
44
**Trigger:** Bestehender Code/System, Bestandsdokumentation, Reverse-Engineer-Anfrage.
55

6+
**Prompt Diet & Execution Rules (RPI Framework):**
7+
- **Isoliertes Research:** Ignoriere zu Beginn (Phase 9a-9e) jegliche Feature-Tickets oder Soll-Zustände des Nutzers. Dokumentiere den Ist-Zustand absolut wertfrei und objektiv.
8+
- **Delta ganz am Schluss:** Wende das Feature-Ticket erst ganz am Ende an, um den Confirmation Bias zu umgehen.
9+
- Gehe in kleinen Schritten vor (Back-and-Forth). Max. 40 Instruktionen pro Interaktion.
10+
611
## Profil-Steuerung
712

813
- **KRITIS:** Beide QS-Schleifen Pflicht (keine Ausnahme); STRIDE + KRITIS-NFRs in generierter Spec; Keine offenen BLOCKER/MAJOR nach QS-2

references/enforcement/enforcement-engine.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -150,6 +150,7 @@ Die F-Stufe eines Prüfpunkts kann je nach Perspektive variieren. In `checks_con
150150
```
151151
── Gate G5 ─────────────────────────────────
152152
[ ] Artefakt-Vollständigkeits-Check (siehe I.6) [F4]
153+
[ ] Plan Fidelity Check (Diff vs plan.md) [F3]
153154
[ ] Alle Tasks aus tasks.md abgeschlossen [F4]
154155
[ ] Spec-First Chain Compliance geprüft [F4]
155156
[ ] ARCHITECTURE.md aktuell [F3]

0 commit comments

Comments
 (0)