analysis-journal

Record reasoning steps as structured YAML journal events during analysis.

Updated Feb 17, 2026
One-click install
npx skills add https://github.com/etoyama/insight-blueprint --skill analysis-journal
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: analysis-journal
Source: https://github.com/etoyama/insight-blueprint/tree/main/skills/analysis-journal
Command: npx skills add https://github.com/etoyama/insight-blueprint --skill analysis-journal

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about analysis-journal

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I record reasoning steps during hypothesis-driven analysis?▼

You can record reasoning steps during hypothesis-driven analysis using a structured Insight Journal that logs observations, hypotheses, evidence, questions, decisions, and conclusions as discrete events in a YAML file.

What is the best way to track evidence and branching across alternative hypotheses?▼

To track evidence and branching across alternative hypotheses, use a structured journal that supports event types like hypothesize, evidence, and branch, storing the evolution tree in a YAML file alongside your design files.

How do I log observations and conclusions in a structured analysis workflow?▼

Log observations and conclusions in a structured analysis workflow by triggering specific event types such as observe, reflect, and conclude, which are persisted chronologically to capture the full reasoning lifecycle.

Can I store analysis journals alongside my existing design files?▼

Yes, you can store analysis journals alongside your design files. The journal is integrated into your design directory and saved at the .insight/designs/ path using a design-specific YAML file for traceability.

Does this hypothesis journaling approach support multilingual prompts?▼

Yes, this hypothesis journaling approach supports multilingual prompts, allowing you to trigger event recording and manage the branching workflow for design evolution in your preferred language.

When do I need a structured journal for hypothesis analysis?▼

You need a structured journal for hypothesis analysis when recording design decisions and reasoning steps becomes tedious, requiring a systematic format to capture branching history and ensure traceability across active workflows.