workflow-failure-forensics

Analyze failed colony workflows to produce forensic reports with root causes.

9|1|Updated Feb 1, 2026
One-click install
npx skills add https://github.com/calcosmic/Aether --skill workflow-failure-forensics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workflow-failure-forensics
Source: https://github.com/calcosmic/Aether/tree/main/.aether/skills-codex/colony/workflow-failure-forensics
Command: npx skills add https://github.com/calcosmic/Aether --skill workflow-failure-forensics

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When colony workflows fail or behave unexpectedly, this Skill provides structured forensic analysis to reconstruct events, identify root causes, and deliver preventive guidance.

Core Features & Use Cases

  • Evidence collection from git history, phase artifacts, pheromone signals, and colony state to support post-mortem investigations.
  • Timeline reconstruction and root-cause analysis to identify failure patterns and propose fixes.
  • Forensic reporting and preventive guidance to resume work and reduce recurrence.

Quick Start

Provide a brief failure scenario and request a forensic report detailing root cause and preventive actions.

Frequently Asked Questions about workflow-failure-forensics

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

FAQPage Schema
How do I conduct a post-mortem for a failed workflow build?

To conduct a post-mortem for a failed workflow build, you gather git history, phase artifacts, pheromone signals, and colony state data to reconstruct events and identify root causes. This forensic analysis delivers preventive guidance to reduce recurrence.

What is root-cause analysis for colony workflow failures?

Root-cause analysis for colony workflow failures is the process of reconstructing event timelines from git history and artifacts to determine why a phase failed or crashed. It identifies failure patterns and generates preventive actions to resume work safely.

How do I investigate unexpected colony states and crashes?

You investigate unexpected colony states and crashes by collecting evidence from pheromone history and colony state data. This reconstructs the operational timeline, identifies what triggered the unexpected state, and produces a forensic report with preventive fixes.

Can I reconstruct a timeline from git history and artifacts after a crash?

Yes, you can reconstruct a timeline from git history and artifacts after a crash. The forensic analysis aggregates these evidence sources alongside pheromone signals to map out the exact sequence of events leading to the workflow failure and propose fixes.

What's the best way to analyze pheromone history during failure analysis?

The best way to analyze pheromone history during failure analysis is to cross-reference it with git history and phase artifacts. This comprehensive evidence collection reconstructs the colony state timeline, highlighting the root cause and guiding preventive fixes.

When should I perform forensic reporting on a failed phase?

You should perform forensic reporting on a failed phase immediately after a build crashes or encounters an unexpected state. Prompt evidence collection from colony artifacts ensures accurate timeline reconstruction and effective preventive guidance.