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.