analysis-journal

What problem does it solve?

Recording the reasoning steps and design decisions during hypothesis-driven analysis can be tedious and error-prone. This skill provides a structured Insight Journal to capture observations, hypotheses, evidence, questions, decisions, reflections, conclusions, and branch history as part of each analysis design.

Core Features & Use Cases

• Structured event journal: Each event records a discrete reasoning step (observe, hypothesize, evidence, question, decide, reflect, conclude, branch) stored in a YAML journal per design.
• Multilingual triggers and workflow: Supports multilingual prompts and a branching workflow for exploring alternative hypotheses.
• Design-integrated persistence: Journal is stored at .insight/designs/{design_id}_journal.yaml alongside the design files, enabling tree-based views and traceability.

Quick Start

Create or load a journal for a given design and begin recording events to capture observations, hypotheses, evidence, questions, decisions, and branches.