analysis-reflection

/analysis-reflection — Structured Analysis Reflection

Guides the user through a structured reflection on their analysis, using the Insight Journal as source material. Helps reach a conclusion, identify remaining gaps, or decide to branch.

When to Use

• Enough evidence has been gathered and it's time to reflect
• Want to assess open questions and decide next steps
• Ready to conclude (transition to supported/rejected/inconclusive)

When NOT to Use

• Still actively investigating (→ /analysis-journal)
• Creating a new design (→ /analysis-design)
• Registering data sources or knowledge (→ /catalog-register)

Workflow

Step 1: Load Design + Journal

1. get_analysis_design(design_id) — load design
2. Read .insight/designs/{design_id}_journal.yaml using Read tool — load journal
3. If no journal exists: "ジャーナルがない。まず /analysis-journal {id} で推論過程を記録してから振り返ろう" → exit

Step 2: Present Analysis Summary

Show structured overview:

── Reflection: {design_id} ──
Title: {title}
Hypothesis: {hypothesis_statement}
Intent: {analysis_intent}
Status: {status}

── Journal Overview ──
Total events: {count}
Phase: {inferred_phase}  (see /analysis-journal Phase Inference rules)
Timeline: {first_event.created_at} → {last_event.created_at}

── Evidence ──
Supporting: {count} items
  - {content} ({created_at})
Contradicting: {count} items
  - {content} ({created_at})

── Decisions Made ──
  - {method} ({package}) — {reason}

── Open Questions ──
  - {question_content} ({event_id})

── Branches ──
  - {child_design_id}: {child_title} ({child_status})

To find branches, use:

children = [d for d in list_analysis_designs(theme_id=design.theme_id) if d.parent_id == design_id]

Step 3: Guided Reflection (3 Questions)

Ask in sequence. Record each answer as a reflect event in the journal.

Q1: Evidence Assessment "証拠を総合すると、仮説「{hypothesis_statement}」についてどう言える？"

• Supporting evidence dominant → supported direction
• Contradicting evidence dominant → rejected direction
• Inconclusive → inconclusive direction or more investigation