runtime-log-triage

Analyze runtime and adapter logs to identify the earliest decisive failure signal.

Updated Apr 19, 2026
One-click install
npx skills add https://github.com/GrinRus/ai_driven_dev_v2 --skill runtime-log-triage
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: runtime-log-triage
Source: https://github.com/GrinRus/ai_driven_dev_v2/tree/main/.agents/skills/runtime-log-triage
Command: npx skills add https://github.com/GrinRus/ai_driven_dev_v2 --skill runtime-log-triage

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the tedious, error-prone work of manually parsing messy runtime and adapter logs to diagnose failed AI workflow stage runs, cutting down troubleshooting time from hours to minutes by surfacing the actual root cause instead of just final error symptoms.

Core Features & Use Cases

  • Earliest Failure Signal Detection: Pinpoints the first decisive failure signal across runtime.log, events.jsonl, and validator-report.md to avoid chasing downstream symptoms.
  • Accurate Failure Classification: Categorizes issues into document, model, adapter, auth, permission, timeout, or environment types to guide fast, targeted fixes.
  • Use Case: When your AIDD stage run fails unexpectedly, use this Skill to quickly determine if the issue is a missing API key, malformed stage document, or runtime timeout, so you can resolve the correct problem without wasted effort.

Quick Start

Use the runtime-log-triage skill to analyze the logs from your failed AIDD stage run and get a clear classification of the root failure cause.

Frequently Asked Questions about runtime-log-triage

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

FAQPage Schema
How do I find the root cause of a failed AIDD workflow stage run?

To find the root cause of a failed AIDD workflow stage run, analyze runtime and adapter logs to identify the earliest decisive failure signal. This classifies issues into document, model, auth, or environment errors, preventing you from chasing downstream symptoms.

What is the best way to analyze runtime logs for adapter authentication failures?

The best way to analyze runtime logs for adapter authentication failures is to pinpoint the earliest failure signal across runtime.log and events.jsonl. This isolates the actual root cause like missing API keys or permission errors instead of final error symptoms.

How does runtime log triage classify workflow troubleshooting errors?

Runtime log triage classifies workflow troubleshooting errors by analyzing adapter logs and validator reports. It categorizes failures into document validation, model, adapter, authentication, permission, timeout, and environment types to guide fast targeted fixes.

Can I use log analysis to detect document validation errors in AI software delivery?

Yes, you can use log analysis to detect document validation errors in AI software delivery. By examining validator-report.md and events.jsonl, the analysis isolates malformed stage documents as the first decisive failure signal for accurate resolution.

Why does my AIDD stage run fail with a timeout error in the runtime logs?

Your AIDD stage run fails with a timeout error in the runtime logs when a runtime timeout is identified as the earliest decisive failure signal. Analyzing the log evidence chain confirms if the timeout is the root cause or a downstream symptom.

What should I do when runtime log analysis shows a model error instead of an adapter error?

When runtime log analysis shows a model error instead of an adapter error, resolve the specific model classification issue. The structured analysis provides an evidence chain ensuring you fix the actual root cause rather than wasting effort on adapter symptoms.