error-flow-audit

Audits multi-step operations for partial failures, unsafe retries, and missing rollback handling.

Updated Aug 29, 2026
One-click install
npx skills add https://github.com/1arley/volibear --skill error-flow-audit-1arley
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: error-flow-audit
Source: https://github.com/1arley/volibear/tree/main/.opencode/skills/error-flow-audit
Command: npx skills add https://github.com/1arley/volibear --skill error-flow-audit-1arley

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Multi-step operations that touch databases, external APIs, queues, and caches can fail between steps, leaving systems in partial or corrupted states that the happy path never produces. This Skill guides an agent to systematically investigate what happens when an operation fails mid-flight instead of only asking whether it works. ## Core Features & Use Cases - Failure Point Mapping: Decomposes operations into steps, labeling each as idempotent, reversible, or an irreversible external effect, then analyzes the state left behind if failure occurs after each step. - Six Failure Classes: Investigates partial success, timeouts, lost responses, retries, crashes, and rollback failures with concrete attack patterns for each. - Evidence-Based Reporting: Produces findings via an audit report template with confidence levels from CONFIRMED (injected failure observed) down to SPECULATIVE, plus explicit false-positive criteria for transactions, sagas, and idempotent designs. - Use Case: When reviewing a checkout flow that writes an order, charges a payment gateway, and sends a confirmation email, use this Skill to identify that a database error after the charge leaves the customer billed with no recorded order. ## Quick Start Audit the checkout operation in this codebase for partial failure states, unsafe retries, and missing rollback coverage.

Frequently Asked Questions about error-flow-audit

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

FAQPage Schema
How do I audit code for partial failure handling?▼

Decompose the operation into individual effects such as database writes, external API calls, and emails. Label each step as idempotent, reversible, or irreversible, then ask what state results if failure occurs after each step and whether rollback covers it.

How to test if a retry duplicates effects in an operation?▼

Re-execute the entire operation after an injected failure and check whether any effect is duplicated, such as a record created twice or an email sent again. If the operation is not idempotent, the retry path is a defect.

What happens when a timeout leaves operation state unknown?▼

A timeout means the system cannot know whether the remote call succeeded. The correct pattern is to query the actual state before retrying; blind retries on non-idempotent operations duplicate effects.

When is a partial failure not a bug?▼

When all writes are covered by a single database transaction with no external effects before commit, rollback is automatic and safe. Saga or outbox patterns with working reconciliation also make inconsistency temporary and handled.

Why are empty catch blocks dangerous in multi-step flows?▼

An empty catch converts a failure into apparent success, making partial states undetectable. The audit treats silent failures, especially combined with irreversible external effects like charges, as the most severe findings.