bv

Analyze Beads.jsonl graphs with nine metrics and generate deterministic recommendations.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Dunc4nJ/agent-skills --skill bv-dunc4nj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bv
Source: https://github.com/Dunc4nJ/agent-skills/tree/main/skills/bv
Command: npx skills add https://github.com/Dunc4nJ/agent-skills --skill bv-dunc4nj

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Beads projects with complex dependency graphs often overwhelm manual triage. BV computes 9 graph metrics and generates deterministic recommendations to surface bottlenecks, plan work, and improve release health, all through an interactive human TUI or robot-friendly flags.

Core Features & Use Cases

  • Graph metrics: PageRank, Betweenness, HITS, Critical Path, Eigenvector, Degree, Density, Cycles, and Topo Sort to reveal project dynamics.
  • Two-phase analysis: instant basic metrics followed by a 500ms phase for deeper analytics, with status reporting for robustness.
  • Robot-ready commands and outputs: triage, plan, insights, and exports for integration with agents and dashboards.
  • Use Cases: triage top bottlenecks in beads.jsonl graphs; generate deterministic execution plans; detect structural issues like cycles.

Quick Start

Start with bv --robot-triage to surface top bottlenecks and generate an actionable plan.

Frequently Asked Questions about bv

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

FAQPage Schema
How do I analyze a beads.jsonl dependency graph to find structural bottlenecks?

Graph-aware triage automates beads.jsonl analysis by computing nine graph metrics, including PageRank, Betweenness, and Critical Path, to surface structural bottlenecks and generate deterministic project recommendations.

How do I detect cycles in a Beads project dependency graph?

You can detect cycles in a Beads project dependency graph by applying topological sort and cycle detection graph metrics, which identify circular dependencies and structural issues within the beads.jsonl data.

Can I integrate Beads project triage into automated CI dashboards?

Yes, you can integrate Beads project triage into automated dashboards by using robot-friendly command flags that output structured JSON, including status, data_hash, and as_of fields for agent consumption.

What graph metrics are used for dependency triage and planning?

Dependency triage and planning use nine graph metrics: PageRank, Betweenness, HITS, Critical Path, Eigenvector, Degree, Density, Cycles, and Topo Sort to reveal project dynamics and execution plans.

Do I need a specific environment to run graph-based health checks on Beads projects?

Running graph-based health checks on Beads projects requires a CLI environment with access to the '.beads/beads.jsonl' file, supporting both interactive human TUI and automated robot flags.

What is the best way to generate a deterministic execution plan from a dependency graph?

The best way to generate a deterministic execution plan from a dependency graph is by applying two-phase graph analysis with topological sorting and critical path metrics to map bottlenecks and sequence work.