challenge-diagnosis

Processes engineer challenges to bug diagnoses using layer or reject revision modes.

Updated Apr 20, 2026
One-click install
npx skills add https://github.com/astroville/sprout --skill challenge-diagnosis-astroville
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: challenge-diagnosis
Source: https://github.com/astroville/sprout/tree/main/.claude/skills/challenge-diagnosis
Command: npx skills add https://github.com/astroville/sprout --skill challenge-diagnosis-astroville

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When an engineer disagrees with an AI-generated bug diagnosis, there is no consistent way to feed that feedback back into the investigation without losing prior reasoning or starting over blindly. This Skill defines a structured protocol for challenging and revising a bug diagnosis while preserving the full reasoning chain. ## Core Features & Use Cases - Mode Detection: Scans engineer feedback for reject signals ("wrong", "start over") versus layer signals ("also consider", "what about") to pick the right revision mode, defaulting to the safer layer mode when ambiguous. - Layer Mode: Merges the engineer's new hypothesis with the existing root cause into a single unified analysis, updating the spec in place. - Reject Mode: Archives the current Root Cause and Fix Plan into Investigation History, clears them, and re-runs the investigation starting from the engineer's hypothesis. - Append-Only History: Maintains a structured Investigation History with dated rounds, confidence levels, and verbatim feedback so no analysis is ever deleted. - Use Case: An engineer reviews a debug spec, believes the diagnosed root cause missed a concurrency issue, and writes "also consider a race condition in the worker pool" — the skill routes this as a layer challenge and produces a merged diagnosis. ## Quick Start Challenge the current bug diagnosis in the spec by providing your feedback and let the skill decide whether to layer it onto or reject the existing root cause.

Frequently Asked Questions about challenge-diagnosis

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

FAQPage Schema
How do I challenge an AI bug diagnosis without losing the original analysis?▼

Provide your feedback on the existing diagnosis and the protocol either layers your hypothesis onto the current root cause or archives the old analysis into Investigation History before re-diagnosing. Previous rounds are never deleted, so the full reasoning chain stays in the spec.

What is the difference between layer mode and reject mode in diagnosis revision?▼

Layer mode treats the existing analysis as valid evidence and merges your new hypothesis into a single unified root cause. Reject mode archives the current Root Cause and Fix Plan as superseded, clears them, and restarts the investigation from your feedback as the starting hypothesis.

How does the skill decide between layer and reject mode?▼

It scans feedback for reject signals like "wrong", "start over", or an explicit --reject flag; everything else defaults to layer mode. When signals are ambiguous, layer mode is chosen because it discards nothing.

Does challenging a diagnosis require the original debugging session?▼

No, the bug spec file on disk is the only input required. The spec contains the Root Cause, Fix Plan, and Investigation History, so the debug-investigator can re-run with full context in a fresh session.

What are the limitations of this diagnosis challenge protocol?▼

It does not auto-accept or auto-reject diagnoses — the engineer always decides. It also does not modify the debug-investigator's core investigation logic; it only changes how the input is framed, and it contains no executable code.