investigate-beads

Set up isolated worktrees and generate structured investigation reports for beads issues.

234|14|Updated Dec 4, 2025
One-click install
npx skills add https://github.com/quarto-dev/q2 --skill investigate-beads
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: investigate-beads
Source: https://github.com/quarto-dev/q2/tree/main/.claude/skills/investigate-beads
Command: npx skills add https://github.com/quarto-dev/q2 --skill investigate-beads

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps practitioners establish an isolated environment to investigate beads issues, gather context from the dependency graph, and produce structured plans and triage verdicts, enabling focused troubleshooting and planning.

Core Features & Use Cases

  • Issue Context Gathering: Automates setup of dedicated worktrees for investigation purposes.
  • Dependency Graph Traversal: Collects detailed information about issue relationships, ensuring comprehensive understanding.
  • Plan Skeleton Generation: Creates preliminary investigation reports with draft phases and design questions to facilitate user alignment.

Quick Start

To investigate a beads issue, run the command to create a dedicated worktree, then generate a plan skeleton and record your observations in the designated notes.

Frequently Asked Questions about investigate-beads

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

FAQPage Schema
How do I triage beads issues in an isolated environment?

To triage beads issues, this Skill sets up dedicated worktrees for investigation, captures dependency graph relationships, and produces structured preliminary reports to aid focused troubleshooting and planning conversations.

What is a dependency graph traversal for issue investigation?

Dependency graph traversal for issue investigation is the process of collecting detailed information about issue relationships within beads, ensuring a comprehensive understanding of dependencies before resolution planning.

How do I generate a plan skeleton for beads issue analysis?

You generate a plan skeleton for beads issue analysis by running the Skill to create a preliminary investigation report containing draft phases and design questions that facilitate user alignment.

Does this issue investigation approach work without external dependencies?

Yes, this issue investigation approach works without external dependencies, allowing you to establish isolated environments and capture dependency relationships using only built-in scripts and references.

What's the best way to streamline beads issue resolution?

The best way to streamline beads issue resolution is to isolate the problem in a dedicated worktree, gather context from the dependency graph, and produce structured triage verdicts for planning.

When should I not use an isolated worktree for issue investigation?

You should not use an isolated worktree for issue investigation when the beads problem requires real-time integration testing or when dependency graph context is unnecessary for simple fixes.