bv

Name: bv
Author: Dicklesworthstone

69stars13forks

How to install bv?

dicklesworthstone/agent_flywheel_clawdbot_skills_and_integrations/bv

$npx -y skills add Dicklesworthstone/agent_flywheel_clawdbot_skills_and_integrations --skill bv

Installs into the current project.

Summary

Beads Viewer - Graph-aware triage engine for Beads projects. Computes PageRank, betweenness, critical path, and cycles. Use --robot-* flags for AI agents.

Files · 1

View on GitHub

SKILL.md

1	# BV - Beads Viewer
2
3	A graph-aware triage engine for Beads projects (`.beads/beads.jsonl`). Computes 9 graph metrics, generates execution plans, and provides deterministic recommendations. Human TUI for browsing; robot flags for AI agents.
4
5	## Why BV vs Raw Beads
6
7	\| Capability \| Raw beads.jsonl \| BV Robot Mode \|
8	\|------------\|-----------------\|---------------\|
9	\| Query \| "List all issues" \| "List the top 5 bottlenecks blocking the release" \|
10	\| Context Cost \| High (linear with issue count) \| Low (fixed summary struct) \|
11	\| Graph Logic \| Agent must compute \| Pre-computed (PageRank, betweenness, cycles) \|
12	\| Safety \| Agent might miss cycles \| Cycles explicitly flagged \|
13
14	Use BV instead of parsing beads.jsonl directly. It computes graph metrics deterministically.
15
16	## CRITICAL: Robot Mode for Agents
17
18	Never run bare `bv`. It launches an interactive TUI that blocks your session.
19
20	Always use `--robot-*` flags:
21
22	```bash
23	bv --robot-triage # THE MEGA-COMMAND: start here
24	bv --robot-next # Minimal: just the single top pick
25	bv --robot-plan # Parallel execution tracks
26	bv --robot-insights # Full graph metrics
27	```
28
29	## The 9 Graph Metrics
30
31	BV computes these metrics to surface hidden project dynamics:
32
33	\| Metric \| What It Measures \| Key Insight \|
34	\|--------\|------------------\|-------------\|
35	\| PageRank \| Recursive dependency importance \| Foundational blockers \|
36	\| Betweenness \| Shortest-path traffic \| Bottlenecks and bridges \|
37	\| HITS \| Hub/Authority duality \| Epics vs utilities \|
38	\| Critical Path \| Longest dependency chain \| Keystones with zero slack \|
39	\| Eigenvector \| Influence via neighbors \| Strategic dependencies \|
40	\| Degree \| Direct connection counts \| Immediate blockers/blocked \|
41	\| Density \| Edge-to-node ratio \| Project coupling health \|
42	\| Cycles \| Circular dependencies \| Structural errors (must fix!) \|
43	\| Topo Sort \| Valid execution order \| Work queue foundation \|
44
45	## Two-Phase Analysis
46
47	BV uses async computation with timeouts:
48
49	- Phase 1 (instant): degree, topo sort, density
50	- Phase 2 (500ms timeout): PageRank, betweenness, HITS, eigenvector, cycles
51
52	Always check `status` field in output. For large graphs (>500 nodes), some metrics may be `approx` or `skipped`.
53
54	## Robot Commands Reference
55
56	### Triage & Planning
57
58	```bash
59	bv --robot-triage # Full triage: recommendations, quick_wins, blockers_to_clear
60	bv --robot-next # Single top pick with claim command
61	bv --robot-plan # Parallel execution tracks with unblocks lists
62	bv --robot-priority # Priority misalignment detection
63	```
64
65	### Graph Analysis
66
67	```bash
68	bv --robot-insights # Full metrics: PageRank, betweenness, HITS, cycles, etc.
69	bv --robot-label-health # Per-label health: healthy\|warning\|critical
70	bv --robot-label-flow # Cross-label dependency flow matrix
71	bv --robot-label-attention # Attention-ranked labels
72	```
73
74	### History & Changes
75
76	```bash
77	bv --robot-history # Bead-to-commit correlations
78	bv --robot-diff --diff-since <ref> # Changes since ref
79	```
80
81	### Other Commands
82
83	```bash
84	bv --robot-burndown <sprint> # Sprint burndown, scope changes
85	bv --robot-forecast <id\|all> # ETA predictions
86	bv --robot-alerts # Stale issues, blocking cascades
87	bv --robot-suggest # Hygiene: duplicates, missing deps, cycle breaks
88	bv --robot-graph # Dependency graph export (JSON, DOT, Mermaid)
89	bv --export-graph <file.html> # Self-contained interactive HTML visualization
90	```
91
92	## Scoping & Filtering
93
94	```bash
95	bv --robot-plan --label backend # Scope to label's subgraph
96	bv --robot-insights --as-of HEAD~30 # Historical point-in-time
97	bv --recipe actionable --robot-plan # Pre-filter: ready to work
98	bv --recipe high-impact --robot-triage # Pre-filter: top PageRank
99	bv --robot-triage --robot-triage-by-track # Group by parallel work streams
100	bv --robot-triage --robot-triage-by-label # Group by domain
101	```
102
103	## Built-in Recipes
104
105	\| Recipe \| Purpose \|
106	\|--------\|---------\|
107	\| `default` \| All open issues sorted by priority \|
108	\| `actionable` \| Ready to work (no blockers) \|
109	\| `high-impact` \| Top PageRank scores \|
110	\| `blocked` \| Waiting on dependencies \|
111	\| `stale` \| Open but untouched for 30+ days \|
112	\| `triage` \| Sorted by computed triage score \|
113	\| `quick-wins` \| Easy P2/P3 items with no blockers \|
114	\| `bottlenecks` \| High betweenness nodes \|
115
116	## Robot Output Structure
117
118	All robot JSON includes:
119	- `data_hash` - Fingerprint of beads.jsonl (verify consistency)
120	- `status` - Per-metric state: `computed\|approx\|timeout\|skipped`
121	- `as_of` / `as_of_commit` - Present when using `--as-of`
122
123	### --robot-triage Output
124
125	```json
126	{
127	"quick_ref": { "open": 45, "blocked": 12, "top_picks": [...] },
128	"recommendations

People who liked this also viewed

6 picks

Type

hyperframes-cliUse the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, SkillsJul 2026262k37k
request-refactor-planSkills for Real Engineers. Straight from my .agents directory.SkillsJul 2026165k181k
analyze-projectRigor Analyze / Rigor Audit read-only skill for deep learning research repositories. Use when the user wants to read and understand a repository, inspect model structure and training or inference entrSkillsMay 2026161k507
explore-codeRigor Improve implementation leaf skill for auditable candidate implementation in deep learning research repositories. Use when the researcher explicitly authorizes exploratory work on an isolated braSkillsMay 2026161k507
ubiquitous-languageSkills for Real Engineers. Straight from my .agents directory.SkillsJul 2026160k181k
scaffold-exercisesSkills for Real Engineers. Straight from my .agents directory.SkillsJul 2026149k181k

bv

69stars13forks

View on GitHub

How to install bv?

dicklesworthstone/agent_flywheel_clawdbot_skills_and_integrations/bv

$npx -y skills add Dicklesworthstone/agent_flywheel_clawdbot_skills_and_integrations --skill bv

Installs into the current project.

Summary

Beads Viewer - Graph-aware triage engine for Beads projects. Computes PageRank, betweenness, critical path, and cycles. Use --robot-* flags for AI agents.

Files · 1

View on GitHub

SKILL.md

1	# BV - Beads Viewer
2
3	A graph-aware triage engine for Beads projects (`.beads/beads.jsonl`). Computes 9 graph metrics, generates execution plans, and provides deterministic recommendations. Human TUI for browsing; robot flags for AI agents.
4
5	## Why BV vs Raw Beads
6
7	\| Capability \| Raw beads.jsonl \| BV Robot Mode \|
8	\|------------\|-----------------\|---------------\|
9	\| Query \| "List all issues" \| "List the top 5 bottlenecks blocking the release" \|
10	\| Context Cost \| High (linear with issue count) \| Low (fixed summary struct) \|
11	\| Graph Logic \| Agent must compute \| Pre-computed (PageRank, betweenness, cycles) \|
12	\| Safety \| Agent might miss cycles \| Cycles explicitly flagged \|
13
14	Use BV instead of parsing beads.jsonl directly. It computes graph metrics deterministically.
15
16	## CRITICAL: Robot Mode for Agents
17
18	Never run bare `bv`. It launches an interactive TUI that blocks your session.
19
20	Always use `--robot-*` flags:
21
22	```bash
23	bv --robot-triage # THE MEGA-COMMAND: start here
24	bv --robot-next # Minimal: just the single top pick
25	bv --robot-plan # Parallel execution tracks
26	bv --robot-insights # Full graph metrics
27	```
28
29	## The 9 Graph Metrics
30
31	BV computes these metrics to surface hidden project dynamics:
32
33	\| Metric \| What It Measures \| Key Insight \|
34	\|--------\|------------------\|-------------\|
35	\| PageRank \| Recursive dependency importance \| Foundational blockers \|
36	\| Betweenness \| Shortest-path traffic \| Bottlenecks and bridges \|
37	\| HITS \| Hub/Authority duality \| Epics vs utilities \|
38	\| Critical Path \| Longest dependency chain \| Keystones with zero slack \|
39	\| Eigenvector \| Influence via neighbors \| Strategic dependencies \|
40	\| Degree \| Direct connection counts \| Immediate blockers/blocked \|
41	\| Density \| Edge-to-node ratio \| Project coupling health \|
42	\| Cycles \| Circular dependencies \| Structural errors (must fix!) \|
43	\| Topo Sort \| Valid execution order \| Work queue foundation \|
44
45	## Two-Phase Analysis
46
47	BV uses async computation with timeouts:
48
49	- Phase 1 (instant): degree, topo sort, density
50	- Phase 2 (500ms timeout): PageRank, betweenness, HITS, eigenvector, cycles
51
52	Always check `status` field in output. For large graphs (>500 nodes), some metrics may be `approx` or `skipped`.
53
54	## Robot Commands Reference
55
56	### Triage & Planning
57
58	```bash
59	bv --robot-triage # Full triage: recommendations, quick_wins, blockers_to_clear
60	bv --robot-next # Single top pick with claim command
61	bv --robot-plan # Parallel execution tracks with unblocks lists
62	bv --robot-priority # Priority misalignment detection
63	```
64
65	### Graph Analysis
66
67	```bash
68	bv --robot-insights # Full metrics: PageRank, betweenness, HITS, cycles, etc.
69	bv --robot-label-health # Per-label health: healthy\|warning\|critical
70	bv --robot-label-flow # Cross-label dependency flow matrix
71	bv --robot-label-attention # Attention-ranked labels
72	```
73
74	### History & Changes
75
76	```bash
77	bv --robot-history # Bead-to-commit correlations
78	bv --robot-diff --diff-since <ref> # Changes since ref
79	```
80
81	### Other Commands
82
83	```bash
84	bv --robot-burndown <sprint> # Sprint burndown, scope changes
85	bv --robot-forecast <id\|all> # ETA predictions
86	bv --robot-alerts # Stale issues, blocking cascades
87	bv --robot-suggest # Hygiene: duplicates, missing deps, cycle breaks
88	bv --robot-graph # Dependency graph export (JSON, DOT, Mermaid)
89	bv --export-graph <file.html> # Self-contained interactive HTML visualization
90	```
91
92	## Scoping & Filtering
93
94	```bash
95	bv --robot-plan --label backend # Scope to label's subgraph
96	bv --robot-insights --as-of HEAD~30 # Historical point-in-time
97	bv --recipe actionable --robot-plan # Pre-filter: ready to work
98	bv --recipe high-impact --robot-triage # Pre-filter: top PageRank
99	bv --robot-triage --robot-triage-by-track # Group by parallel work streams
100	bv --robot-triage --robot-triage-by-label # Group by domain
101	```
102
103	## Built-in Recipes
104
105	\| Recipe \| Purpose \|
106	\|--------\|---------\|
107	\| `default` \| All open issues sorted by priority \|
108	\| `actionable` \| Ready to work (no blockers) \|
109	\| `high-impact` \| Top PageRank scores \|
110	\| `blocked` \| Waiting on dependencies \|
111	\| `stale` \| Open but untouched for 30+ days \|
112	\| `triage` \| Sorted by computed triage score \|
113	\| `quick-wins` \| Easy P2/P3 items with no blockers \|
114	\| `bottlenecks` \| High betweenness nodes \|
115
116	## Robot Output Structure
117
118	All robot JSON includes:
119	- `data_hash` - Fingerprint of beads.jsonl (verify consistency)
120	- `status` - Per-metric state: `computed\|approx\|timeout\|skipped`
121	- `as_of` / `as_of_commit` - Present when using `--as-of`
122
123	### --robot-triage Output
124
125	```json
126	{
127	"quick_ref": { "open": 45, "blocked": 12, "top_picks": [...] },
128	"recommendations

People who liked this also viewed

6 picks

Type