flowai-reflect-by-history

Analyze historical IDE session transcripts to classify recurring agent behavior patterns and issues.

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/korchasa/flowai-workflow --skill flowai-reflect-by-history
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: flowai-reflect-by-history
Source: https://github.com/korchasa/flowai-workflow/tree/main/.claude/skills/flowai-reflect-by-history
Command: npx skills add https://github.com/korchasa/flowai-workflow --skill flowai-reflect-by-history

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyze previous IDE session transcripts to surface recurring agent behavior patterns, systemic workflow issues, and gaps in project primitives so teams can prioritize durable fixes instead of repeated ad-hoc remedies. The Skill focuses exclusively on historical sessions (not the current live session) and avoids fabricating findings when history is absent.

Core Features & Use Cases

  • Discovery & scope selection: Detect Claude Code, Cursor, or OpenCode artifacts and choose project-local or user-level session files according to availability and user intent.
  • Session parsing & extraction: Read JSONL or local SQLite session transcripts, extract titles, user requests, tool usage sequences, errors, timestamps, and primitive invocations while skipping irrelevant event types.
  • Cross-session pattern detection and classification: Identify recurring errors, repeated manual workflows, ad-hoc decisions, unchecked invariants, and missing documentation, then map each proposed corrective action to Rule, Skill, Command, Hook, Project Docs, or Code Change.
  • Actionable reporting: Produce a scoped report with evidence, frequency counts, priorities, and suggested artifacts to implement.

Quick Start

Analyze the last five project sessions to produce a prioritized report of recurring errors, tool usage patterns, and recommended fixes classified by artifact type.

Frequently Asked Questions about flowai-reflect-by-history

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

FAQPage Schema
How do I analyze past Claude Code or Cursor session logs to find recurring errors?

Session log analysis detects recurring agent behavior patterns by parsing historical IDE transcripts to extract tool usage, errors, and timestamps. It identifies repeated manual workflows and missing primitives, producing a classified report with evidence and recommended fixes.

What is the best way to detect repeated manual workflows in OpenCode session history?

The best way to detect repeated manual workflows is cross-session pattern detection applied to historical OpenCode transcripts. It extracts primitive invocations and tool usage sequences, classifies recurring ad-hoc decisions, and maps corrective actions to Rules, Skills, or Commands.

Can I review project-local Claude session files to identify missing documentation?

Yes, you can review project-local Claude session files to identify missing documentation. The analysis parses transcripts to extract user requests and primitive invocations, detects unchecked invariants and documentation gaps, and maps corrective actions to Project Docs or Code Changes.

How do I generate a prioritized report of agent behavior issues from JSONL session transcripts?

Generate a prioritized report by reading JSONL session transcripts to extract tool usage, errors, and timestamps. Cross-session pattern detection classifies recurring issues with frequency counts and evidence, recommending specific artifacts like Hooks or Rules to implement durable fixes.

Does historical session analysis work on the current live IDE session?

No, historical session analysis focuses exclusively on previous sessions and explicitly excludes the active live session. It reads local JSONL or SQLite session files to surface recurring errors and systemic workflow issues without fabricating findings when history is absent.

Why should I analyze agent behavior patterns across past sessions instead of fixing errors ad-hoc?

Analyzing agent behavior patterns across past sessions surfaces systemic workflow issues and gaps in project primitives, allowing teams to prioritize durable fixes. It classifies recurring errors and ad-hoc decisions, mapping them to specific artifacts like Rules, Skills, or Commands instead of repeated remedies.