blueprint-debug

Diagnose Blueprint issues through structured investigations and durable evidence-backed reports.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/rakole/blueprint --skill blueprint-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blueprint-debug
Source: https://github.com/rakole/blueprint/tree/main/skills/blueprint-debug
Command: npx skills add https://github.com/rakole/blueprint --skill blueprint-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnoses and recovers from Blueprint issues by coordinating structured investigations, capturing evidence, and persisting durable debug reports with explicit follow-up tasks.

Core Features & Use Cases

  • Structured, bounded debugging workflow that keeps diagnosis auditable.
  • Durable reporting stored in the repository to survive session resets.
  • Clear routing and integration with Blueprint MCP tools to guide the next steps.

Quick Start

Start a debugging session by issuing /blu-debug with a clear issue statement.

Frequently Asked Questions about blueprint-debug

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

FAQPage Schema
How do I debug long-running Blueprint issues with evidence collection?

Use /blu-debug with a clear issue statement to start a structured debugging workflow. It orchestrates diagnosis, captures evidence, and persists durable reports directly in your repository to survive session resets.

What is a durable debug report and when do I need one?

A durable debug report is a persistent, evidence-backed artifact stored in the repository to track long-running Blueprint investigations. You need one when evidence collection and follow-up tasks must survive session resets and guide next steps.

How do I start a structured debugging workflow in a Blueprint project?

Start a structured debugging workflow by issuing /blu-debug with a clear issue statement. This initiates bounded investigation, evidence capture, and durable report generation with explicit follow-up tasks for your Blueprint project.

Does blueprint-debug work with Blueprint MCP tools for routing?

Yes, this debugging workflow integrates with Blueprint MCP tools to ensure safe routing and guide next steps. It satisfies runtime rules and workflow constraints while orchestrating structured investigations and durable reporting.

What are the limitations of using a structured debugging workflow for diagnosis?

Structured debugging workflows are bounded and designed for long-running Blueprint scenarios with persistent reporting needs. They may not suit quick, isolated fixes that require no evidence collection or durable report artifacts.