From 3c7d336c93ac6d18a73140b8814ec7cf9d681869 Mon Sep 17 00:00:00 2001 From: Christian Nennemann Date: Sat, 4 Apr 2026 08:48:52 +0200 Subject: [PATCH] feat: add Explorer skip heuristic to plan-phase skill --- skills/plan-phase/SKILL.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/skills/plan-phase/SKILL.md b/skills/plan-phase/SKILL.md index 1db9fd4..ea2e493 100644 --- a/skills/plan-phase/SKILL.md +++ b/skills/plan-phase/SKILL.md @@ -117,3 +117,19 @@ When the Creator receives structured feedback from a prior cycle, the proposal m - **Disputed:** Disagrees with the finding. Must provide evidence or reasoning. CRITICAL findings cannot be deferred or disputed — they must be fixed or the proposal will be rejected again. + +## Explorer Skip Conditions + +Not every task needs Explorer research. Use this decision table: + +| Condition | Skip Explorer? | Reason | +|-----------|---------------|--------| +| Task names specific files (1-2) and change is clear | **Yes** | Context is already known | +| Bug fix with stack trace or error message | **Yes** | Root cause is locatable without research | +| High confidence + small scope (single function/class) | **Yes** | Creator can mini-reflect instead | +| Task contains "investigate", "research", "explore" | **No** | Explicit research request | +| Task affects >3 files or unknown scope | **No** | Need dependency mapping | +| Unfamiliar area of codebase (no recent commits by team) | **No** | Need pattern discovery | +| Security-sensitive change (auth, crypto, input handling) | **No** | Need risk surface mapping | + +When Explorer is skipped, Creator MUST include the **Mini-Reflect** section in its proposal to compensate for missing research context.