QCOE

Guides structured Correction of Errors analysis with 5-Whys root cause investigation and COE document generation.

Updated Jan 29, 2026
One-click install
npx skills add https://github.com/sparkst/sparkry-claude-skills --skill qcoe-sparkst
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: QCOE
Source: https://github.com/sparkst/sparkry-claude-skills/tree/main/plugins/coe-workflow/skills/qcoe
Command: npx skills add https://github.com/sparkst/sparkry-claude-skills --skill qcoe-sparkst

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Post-incident reviews often end with vague conclusions like "someone forgot" and no lasting fixes. This Skill walks you through a disciplined Correction of Errors (COE) process that forces evidence-based 5-Whys analysis, structural root causes, and deterministic preventive mechanisms, producing a publishable COE document. ## Core Features & Use Cases - Structured 10-Phase Workflow: From pattern scan and severity classification through timeline building, 5-Whys analysis, corrective actions, and preventive mechanisms, ending in a saved COE document. - Evidence-Based Root Cause Analysis: Every Why requires a citation (file path, commit hash, log entry, or user-reported), and behavioral root causes are rejected in favor of structural ones. - Repeat Pattern Detection: Scans prior COEs and git history to flag recurring failure classes before analysis begins. - Use Case: After discovering that standing orders were dispatched to the wrong agent for two weeks, run the COE workflow to classify severity, reconstruct the timeline from git history, derive the structural root cause, and generate a COE document with deterministic preventive mechanisms and metrics to watch. ## Quick Start Ask the AI to run a COE on a recent incident, for example: run a COE on the bug where customer invoices were sent twice last Friday.

Frequently Asked Questions about QCOE

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

FAQPage Schema
How do I run a root cause analysis with 5 Whys?▼

Invoke the COE workflow with a free-form incident description, and it generates a full 5-Whys chain with evidence citations for your review. You can correct any Why before the root cause is synthesized and the COE document is written.

How to write a post-mortem or COE document after an incident?▼

The workflow gathers incident context, classifies severity, builds a timeline from git history and logs, then assembles a COE document from a template. The output includes corrective actions, preventive mechanisms, metrics, and a JSON metadata block.

Can I resume an unfinished COE draft?▼

Yes, pass the --resume flag with the draft file path. The workflow reads the draft, identifies the last completed phase, and continues from the next phase after your confirmation.

Does the COE workflow work without a git repository?▼

Yes, it falls back to user-provided narrative and marks timeline entries as approximate or user-reported. The document notes that limited forensic evidence was available.

What happens if the root cause is behavioral, like someone forgetting a step?▼

Behavioral root causes are rejected. The analysis pushes one level deeper to identify the missing structural mechanism, and preventive mechanisms must be deterministic, automatic, and testable rather than relying on memory.

Does the COE process detect repeat incidents?▼

Yes, a pattern scan greps prior COE documents and git history for keyword overlap before analysis begins. Repeat patterns are flagged explicitly so the analysis addresses why prior fixes did not hold.