From 5139f1ad893f227268b75eb94f179bc35ca8a199 Mon Sep 17 00:00:00 2001
From: Christian Nennemann <christian@nennemann.de>
Date: Fri, 3 Apr 2026 06:08:01 +0200
Subject: [PATCH] =?UTF-8?q?feat:=20Ralph=20Loop=20integration=20=E2=80=94?=
 =?UTF-8?q?=20mini-reflect,=20alternatives,=20structured=20confidence?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Mini-Reflect for fast workflow: Creator must restate task, list assumptions,
  name highest-damage risk before proposing (catches misunderstandings early)
- Alternatives Considered section: Creator must evaluate 2+ approaches with
  rejection rationale before committing to one (prevents tunnel vision)
- Structured confidence scoring: 3-axis table (task understanding, solution
  completeness, risk coverage) replaces bare 0.0-1.0 number. Low scores
  trigger targeted action (clarify, upgrade workflow, or research)
- Mini-Reflect fallback for skipped tasks: quick reflection even when
  ArcheFlow doesn't activate (non-trivial single-file changes)
---
 skills/orchestration/SKILL.md   | 19 +++++++++++++++----
 skills/plan-phase/SKILL.md      | 29 +++++++++++++++++++++++++++--
 skills/using-archeflow/SKILL.md |  2 ++
 3 files changed, 44 insertions(+), 6 deletions(-)

diff --git a/skills/orchestration/SKILL.md b/skills/orchestration/SKILL.md
index 84e19aa..523f0af 100644
--- a/skills/orchestration/SKILL.md
+++ b/skills/orchestration/SKILL.md
@@ -47,19 +47,30 @@ Agent(
 **Context to include:** Task description, Explorer's research output. On cycle 2+: prior cycle's structured feedback (see Cycle Feedback Protocol).
 **Context to exclude:** Raw file contents (Explorer already summarized), git diffs, reviewer full outputs.
 
+**Fast workflow only (no Explorer):** The Creator must perform a Mini-Reflect before proposing:
+1. Restate the task in your own words (catch misunderstandings early)
+2. List 3 assumptions you're making
+3. Name the one risk that would cause most damage if wrong
+
 ```
 Agent(
   description: "🏗️ Creator: design proposal",
   prompt: "<task description>
     You are the CREATOR archetype.
-    Based on the research findings: <Explorer's output>
+    <if fast workflow (no Explorer): Before proposing, perform a Mini-Reflect:
+      1. Restate the task in one sentence
+      2. List 3 assumptions you're making
+      3. Name the highest-damage risk
+      Then propose.>
+    <if standard/thorough: Based on the research findings: <Explorer's output>>
     <if cycle 2+: Prior cycle feedback: <structured feedback — see Cycle Feedback Protocol>>
     Design a solution proposal including:
     1. Architecture decisions (with rationale)
     2. Files to create/modify (with specific changes)
-    3. Test strategy
-    4. Confidence score (0.0 to 1.0)
-    5. Risks you foresee
+    3. Alternatives considered (at least 2, with rejection rationale)
+    4. Test strategy
+    5. Confidence (scored by axis: task understanding, solution completeness, risk coverage)
+    6. Risks you foresee
     <if cycle 2+: 6. How you addressed each unresolved issue from prior feedback>
     Be decisive. Ship a clear plan, not a menu of options.",
   subagent_type: "Plan"
diff --git a/skills/plan-phase/SKILL.md b/skills/plan-phase/SKILL.md
index f558340..d63c8f5 100644
--- a/skills/plan-phase/SKILL.md
+++ b/skills/plan-phase/SKILL.md
@@ -32,11 +32,21 @@ Explorer researches, then Creator designs. Sequential — Creator needs Explorer
 
 ```markdown
 ## Proposal: <task>
-**Confidence:** <0.0 to 1.0>
+
+### Mini-Reflect (fast workflow only — skip if Explorer ran)
+- **Task restated:** <one sentence>
+- **Assumptions:** 1) ... 2) ... 3) ...
+- **Highest-damage risk:** <the one thing that would hurt most if wrong>
 
 ### Architecture Decision
 <What and WHY>
 
+### Alternatives Considered
+| Approach | Why Rejected |
+|----------|-------------|
+| <option A> | <reason> |
+| <option B> | <reason> |
+
 ### Changes
 1. **`path/file.ext`** — What changes and why
 2. **`path/test.ext`** — What tests to add
@@ -44,6 +54,13 @@ Explorer researches, then Creator designs. Sequential — Creator needs Explorer
 ### Test Strategy
 - <specific test cases>
 
+### Confidence
+| Axis | Score | Note |
+|------|-------|------|
+| Task understanding | <0.0-1.0> | <why> |
+| Solution completeness | <0.0-1.0> | <gaps?> |
+| Risk coverage | <0.0-1.0> | <unknowns?> |
+
 ### Risks
 - <what could go wrong + mitigations>
 
@@ -51,13 +68,14 @@ Explorer researches, then Creator designs. Sequential — Creator needs Explorer
 - <adjacent concerns deliberately excluded>
 ```
 
+**Confidence triggers:** If any axis scores below 0.5, flag it to the orchestrator. Low task understanding → clarify with user. Low solution completeness → consider standard workflow. Low risk coverage → spawn targeted Explorer research.
+
 ## Creator with Prior Feedback (Cycle 2+)
 
 When the Creator receives structured feedback from a prior cycle, the proposal must include an additional section addressing each unresolved issue:
 
 ```markdown
 ## Proposal: <task> (Revision — Cycle N)
-**Confidence:** <0.0 to 1.0>
 
 ### Prior Feedback Response
 | Issue | Source | Action | Rationale |
@@ -75,6 +93,13 @@ When the Creator receives structured feedback from a prior cycle, the proposal m
 ### Test Strategy
 <updated test cases>
 
+### Confidence
+| Axis | Score | Note |
+|------|-------|------|
+| Task understanding | <0.0-1.0> | <why> |
+| Solution completeness | <0.0-1.0> | <gaps?> |
+| Risk coverage | <0.0-1.0> | <unknowns?> |
+
 ### Risks
 <updated risks — include any new risks from the revision>
 
diff --git a/skills/using-archeflow/SKILL.md b/skills/using-archeflow/SKILL.md
index 258ecd9..bcdbd34 100644
--- a/skills/using-archeflow/SKILL.md
+++ b/skills/using-archeflow/SKILL.md
@@ -36,6 +36,8 @@ Do NOT use ArcheFlow for these — just do them directly:
 - Config changes to a single file
 - Git operations (commit, push, branch)
 
+**Mini-Reflect fallback:** Even when skipping ArcheFlow, apply a quick reflection for non-trivial single-file changes: (1) restate what you're changing, (2) name one assumption, (3) check if it could break anything. This takes ~10 seconds and catches misunderstandings before they become commits.
+
 ## Archetypes
 
 | Archetype | Avatar | Virtue | Shadow | Phase |