Skip to content

shinpr/nautilus / .agents/skills/recipe-reflect

recipe-reflect

Verified

Orchestrates reflection by updating affected artifacts and distilling reusable knowledge from validation results.

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).

Required Skills [LOAD BEFORE EXECUTION]

  1. [LOAD IF NOT ACTIVE] product-principles — Knowledge Pyramid and promotion criteria
  2. [LOAD IF NOT ACTIVE] hypothesis-discipline — validation results, lifecycle status, and confidence changes

Delegate Level 2 and Level 3 distillation to knowledge-distiller for independent evidence synthesis.

Execution Decision Flow

1. Scope Assessment

Input: Use the path or text supplied with the explicit skill invocation. If no input was supplied and the target cannot be inferred unambiguously, ask for it.

Determine the reflection level (see references/reflection-guide.md):

TriggerLevelTarget Files
Hypothesis concludedLevel 1: HypothesisThe hypothesis file
Multiple hypotheses concluded under an OpportunityLevel 2: OpportunityOpportunity file (Tier 2 Learnings section)
PRD delivered, quarterly review, strategic pivotLevel 3: Visiondocs/product/vision.md, docs/product/learnings.md

2. Result Recording

Level 1: Hypothesis Reflection

  1. Verify the hypothesis file has been updated with results (validation results, confidence scores, evidence)
  2. Document a learning when the result changes the parent Opportunity or a later decision
  3. Check if this result changes understanding of the parent Opportunity

Level 2: Opportunity Reflection

  1. Start from the Opportunity and load the hypothesis evidence needed to assess candidate learnings and contradictions
  2. Prepare context for knowledge-distiller (hypothesis summaries, results, confidence changes)

Level 3: Vision Reflection

  1. Gather the cross-Opportunity evidence needed for the outcome, NSM, or Tier 1 decision
  2. Review Product Outcomes — are targets still correct?
  3. Review NSM — still the right connecting metric?
  4. Prepare context for knowledge-distiller

3. Knowledge Distillation

Invoke knowledge-distiller for evidence distillation:

  • knowledge-distiller operates in a separate context to avoid individual hypothesis bias
  • It distills evidence into candidate learnings and contradictions
  • It proposes Tier 2 learnings (for Opportunity) or Tier 1 learnings (for Vision)
  • It enforces distillation quality criteria (per product-principles skill)

Present distillation results to the user for the knowledge-promotion decision:

  • Candidate learnings with proposed tiers, supporting evidence, and contexts
  • Contradictions found and the decisions they may affect

End the current turn with the distillation result as the workflow output. Promote knowledge only after the user confirms the proposal in a later turn.

4. Knowledge Promotion

After that confirmation:

Tier 3 → Tier 2

  • Write learnings to the Opportunity file's "Tier 2 Learnings" section
  • Include hypothesis references that support each learning

Tier 2 → Tier 1

  • Write to docs/product/learnings.md
  • Include supporting evidence references and their dates
  • State the contexts where the learning applies

Sub-agent Usage

AgentWhenWhy (context separation benefit)
knowledge-distillerLevel 2 and Level 3 reflectionIndependent evidence synthesis across hypotheses

Scope Boundaries

Included: Result recording, knowledge distillation, and Tier promotion Not included: Hypothesis validation (→ recipe-validate), new hypothesis generation (→ recipe-discover)

Completion

The workflow is complete when approved promotions are updated, or a no-change result is reported with the evidence and contradictions relevant to the decision.

slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall