flow-reflect

Diagnose agent execution failures and recommend improvements from task transcripts.

3|Updated Oct 5, 2025
One-click install
npx skills add https://github.com/korchasa/flow --skill flow-reflect
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: flow-reflect
Source: https://github.com/korchasa/flow/tree/main/framework/skills/flow-reflect
Command: npx skills add https://github.com/korchasa/flow --skill flow-reflect

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyzes the agent's execution history to diagnose failures in the Thought–Action–Result loop and identify suboptimal decisions, enabling teams to improve reliability and safety.

Core Features & Use Cases

  • Audits agent task flows to surface behavioral errors (loops, false assumptions, ignored feedback) and technical decision flaws (overengineering, poor error handling, brittle designs).
  • Identifies context gaps and undocumented discoveries, proposing concrete improvements to project instructions, guidelines, and tooling.
  • Supports post-task retrospectives, design reviews, and ongoing coaching for AI agents to align with project standards.

Quick Start

Review the latest task transcript and project guidelines, then produce a concise reflection highlighting root causes and recommended actions.

Frequently Asked Questions about flow-reflect

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

FAQPage Schema
How do I diagnose failures in an AI agent's Thought-Action-Result loop?▼

Diagnose Thought-Action-Result loop failures by auditing the agent's execution history to identify suboptimal decisions, behavioral errors like ignored feedback, and technical flaws in engineering choices.

Why does my AI agent workflow repeat errors and ignore project guidelines?▼

AI agent workflows repeat errors when context gaps and undocumented discoveries exist; auditing the task transcript against project guidelines surfaces these root causes to enforce evidence-based improvements.

What is the best way to run a retrospective on an automated agent task session?▼

Run an agent task retrospective by examining the execution history to surface behavioral loops, false assumptions, and brittle designs, producing concrete recommendations for future session reliability.

Can I use a task transcript to identify overengineering and poor error handling in agent decisions?▼

Yes, you can use a task transcript to audit agent task flows, specifically surfacing technical decision flaws like overengineering, poor error handling, and brittle designs for design reviews.

Does auditing an AI workflow require access to project guidelines and task transcripts?▼

Yes, auditing an AI workflow requires access to both the task transcript and project guidelines to identify context gaps and propose concrete improvements to instructions and tooling.

What are the limitations of auditing agent execution history for process reliability?▼

Auditing agent execution history focuses strictly on process reliability, engineering choices, and context usage, meaning it only produces concrete recommendations for future sessions rather than live runtime corrections.