Orchestrate structured reflection — update target artifacts with learnings, distill knowledge across hypotheses, and maintain INDEX.md
Context: Drive the feedback loop by reflecting on outcomes, updating target artifacts, and distilling learnings across the knowledge pyramid (see product-principles skill for Tier definitions).
Execution Protocol:
[STOP — BLOCKING] marker — present findings and CANNOT proceed until user explicitly confirmsInput (reflection trigger — hypothesis concluded, Opportunity review, or periodic)
↓
1. Scope Assessment → Determine reflection level (hypothesis / Opportunity / Vision)
↓
2. Result Recording → Update target artifacts with outcomes
↓
3. Knowledge Distillation → knowledge-distiller extracts patterns [Stop: Distillation review]
↓
4. Knowledge Promotion → Tier 2 → Tier 1 if criteria met
↓
5. Index Update → Update INDEX.md
↓
Output: Updated artifacts + learnings + INDEX.md
Input: $ARGUMENTS
Determine the reflection level (see references/reflection-guide.md):
| Trigger | Level | Target Files |
|---|---|---|
| Hypothesis concluded | Level 1: Hypothesis | The hypothesis file |
| Multiple hypotheses concluded under an Opportunity | Level 2: Opportunity | Opportunity file (Tier 2 Learnings section) |
| PRD delivered, quarterly review, strategic pivot | Level 3: Vision | docs/product/vision.md, docs/product/learnings.md |
Invoke knowledge-distiller using Agent tool (subagent_type: "discover:knowledge-distiller") for pattern extraction:
[STOP — BLOCKING] Present distillation results to user for review:
CANNOT write learnings or promote Tiers until user explicitly confirms.
After user approval:
docs/product/learnings.mdlast-validated: YYYY-MM-DD)Update docs/discovery/INDEX.md with:
| Agent | When | Why (context separation benefit) |
|---|---|---|
| knowledge-distiller (subagent_type: "discover:knowledge-distiller") | Level 2 and Level 3 reflection | Unbiased pattern extraction across individual hypotheses |
Included: Result recording, knowledge distillation, Tier promotion, INDEX.md maintenance Not included: Hypothesis validation, new hypothesis generation
docs/discovery/INDEX.md updated