mirror of
https://github.com/hanzoai/skills.git
synced 2026-11-19 00:47:36 +00:00
hanzoskills.com/llms.txt now opens with the install line, the API reference index and the company index, so an agent that lands on any one of the three can find the rest. robots.txt claimed 537 documents while llms.txt counts 920. The number is gone from robots.txt; llms.txt derives it. public/ is regenerated from scripts/site.py, which it had fallen behind: the copy-prompt menu and agent bar were in the generator and not in the committed pages. tests/site.mjs passes against the result. Co-authored-by: Hanzo Dev <[email protected]>
422 lines
23 KiB
HTML
422 lines
23 KiB
HTML
<!doctype html>
|
|
<html lang="en"><head>
|
|
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
|
|
<title>beads-dependency-management</title>
|
|
<meta name="color-scheme" content="dark">
|
|
<style>
|
|
/* Committed to one visual world: a dark instrument panel. No light variant —
|
|
the dot field and the hairline rules only read on black, and a naive
|
|
inversion would wash both out. Every colour is painted explicitly so the page
|
|
never borrows a host background. */
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
|
|
|
|
:root{
|
|
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
|
|
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
|
|
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
|
|
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
|
|
--font-zen-pixel-square:'Zen Pixel Square',monospace;
|
|
--mono:var(--font-zen-mono);
|
|
--sans:var(--font-zen-sans);
|
|
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
|
|
--r:999px; --r-soft:14px;
|
|
}
|
|
*{box-sizing:border-box}
|
|
html{-webkit-text-size-adjust:100%}
|
|
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
|
|
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
|
|
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
|
|
|
|
/* The dot field. A halftone made of one repeating radial-gradient, faded out
|
|
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
|
|
/* No overflow clip here: the dot field is inset to the box already, and a clip
|
|
would cut off the copy-prompt menu. */
|
|
.hero{position:relative;border-bottom:1px solid var(--line)}
|
|
.hero::before{content:"";position:absolute;inset:0;
|
|
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
|
|
background-size:7px 7px;
|
|
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
pointer-events:none}
|
|
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
|
|
|
|
nav{border-bottom:1px solid var(--line)}
|
|
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
|
|
justify-content:space-between;align-items:center;gap:1rem}
|
|
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--ink);text-decoration:none;
|
|
display:inline-flex;align-items:center;gap:.6rem}
|
|
.brand i{font-style:normal;color:var(--faint)}
|
|
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
|
|
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--soft);text-decoration:none}
|
|
nav a.up:hover{color:var(--ink)}
|
|
|
|
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
|
|
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
|
|
h1 em{font-style:normal;color:var(--faint)}
|
|
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
|
|
|
|
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
|
|
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
|
|
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
|
|
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
|
|
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
|
|
line-height:1.2;font-weight:400}
|
|
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
|
|
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
|
|
.btn.solid:hover{background:#d8d8d4}
|
|
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
|
|
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
|
|
|
|
/* Copy-prompt selector. Each row copies the prompt for its own target. */
|
|
.copy{position:relative;display:inline-flex}
|
|
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
|
|
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
|
|
padding:.4rem;display:flex;flex-direction:column;
|
|
box-shadow:0 12px 32px rgba(0,0,0,.75)}
|
|
.menu[hidden]{display:none}
|
|
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
|
|
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
|
|
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
|
|
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
|
|
white-space:nowrap}
|
|
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
|
|
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
|
|
.mi:hover .mark{color:var(--ink)}
|
|
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
|
|
letter-spacing:.1em;text-transform:uppercase}
|
|
|
|
/* Works-with bar: one scrolling row, name and mark per agent. */
|
|
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
|
|
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
|
|
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
|
|
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
|
|
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
|
|
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
|
|
display:flex;align-items:center}
|
|
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
|
|
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
|
|
-webkit-overflow-scrolling:touch;
|
|
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
|
|
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
|
|
.bar::-webkit-scrollbar{display:none}
|
|
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
|
|
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
|
|
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
|
|
text-decoration:none;background:var(--ground)}
|
|
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
|
|
.agent .mark{width:.95rem;height:.95rem}
|
|
|
|
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
|
|
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
|
|
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
|
|
p{margin:0 0 1rem;max-width:70ch}
|
|
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
|
|
li{margin:.22rem 0}
|
|
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
|
|
text-decoration-color:var(--line-hi)}
|
|
a:hover{text-decoration-color:var(--ink)}
|
|
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
|
|
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
|
|
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
|
|
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
|
|
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
|
|
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
|
|
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
|
|
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
|
|
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
|
|
display:block;overflow-x:auto}
|
|
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
|
|
|
|
.curl{display:block;background:var(--panel);border:1px solid var(--line);
|
|
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
|
|
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
|
|
white-space:pre;line-height:1.9}
|
|
.curl b{color:var(--ink);font-weight:400}
|
|
.curl i{font-style:normal;color:var(--faint)}
|
|
|
|
/* index */
|
|
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
|
|
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
|
|
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
|
|
#q:focus{outline:none;border-color:var(--soft)}
|
|
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
|
|
text-transform:uppercase;margin:0 0 2rem}
|
|
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
|
|
padding-bottom:.45rem}
|
|
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
|
|
border-radius:var(--r-soft);text-decoration:none}
|
|
.row:hover{background:#0a0a0a}
|
|
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
|
|
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
|
|
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
|
|
color:var(--faint);font-size:.85rem}
|
|
footer a{color:var(--soft)}
|
|
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
|
|
margin:0 0 2rem;font-size:.85rem}
|
|
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
|
|
border-bottom:1px solid var(--line);padding-bottom:.4rem}
|
|
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
|
|
.fmap a:hover{text-decoration:underline}
|
|
.fmap div{color:var(--faint);line-height:1.5}
|
|
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
|
|
|
|
@media (max-width:640px){
|
|
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
|
|
.btns{gap:.5rem}
|
|
.btn{padding:.75rem 1.15rem;font-size:.68rem}
|
|
.copy,.copy .btn{width:100%;justify-content:center}
|
|
.menu{left:0;right:0;min-width:0}
|
|
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
|
|
.strip b{border-right:0;padding-right:0}
|
|
.bar{width:100%}
|
|
}
|
|
</style>
|
|
<link rel="alternate" type="text/markdown" href="/beads-dependency-management.md">
|
|
|
|
<link rel="icon" href="/favicon.svg">
|
|
<link rel="canonical" href="https://hanzoskills.com/beads-dependency-management">
|
|
</head>
|
|
<!-- Reading this with a machine? Every page here is also plain markdown.
|
|
This one: https://hanzoskills.com/beads-dependency-management.md
|
|
Index: https://hanzoskills.com/llms.txt
|
|
Corpus: https://hanzoskills.com/all.md
|
|
Append .md to any path for the markdown twin. -->
|
|
<body>
|
|
<nav><div class="in">
|
|
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
|
|
<a class="up" href="/">All skills</a>
|
|
</div></nav>
|
|
|
|
<div class="wrap">
|
|
<h1>beads-dependency-management</h1><p class="lede">Use this skill when: Creating relationships between issues, managing blockers, or organizing work hierarchies</p><h1>Beads Dependency Management</h1>
|
|
<p><strong>Use this skill when:</strong> Creating relationships between issues, managing blockers, or organizing work hierarchies</p>
|
|
<h2>Overview</h2>
|
|
<p>Beads supports four dependency types that create a directed graph of issue relationships. Understanding when to use each type is critical for effective issue tracking.</p>
|
|
<h2>Dependency Types</h2>
|
|
<h3>1. <code>blocks</code> - Hard Blocker</h3>
|
|
<p><strong>Purpose:</strong> Prevents an issue from being "ready" until the blocker is closed</p>
|
|
<p><strong>Use when:</strong> Implementation of X literally cannot proceed without Y being done first</p>
|
|
<pre><code class="lang-bash"># bd-15 cannot start until bd-10 is complete
|
|
bd dep add bd-15 bd-10 --type blocks
|
|
|
|
# bd-15 won't appear in `bd ready` until bd-10 is closed</code></pre>
|
|
<p><strong>Example Use Cases:</strong></p>
|
|
<ul><li>Database schema must exist before migration</li><li>Authentication system before protected endpoints</li><li>Core library before dependent features</li><li>Design approval before implementation</li></ul>
|
|
<p><strong>Graph Representation:</strong></p>
|
|
<pre><code>bd-10 --> bd-15 (bd-10 blocks bd-15)</code></pre>
|
|
<h3>2. <code>related</code> - Soft Association</h3>
|
|
<p><strong>Purpose:</strong> Creates context link without blocking</p>
|
|
<p><strong>Use when:</strong> Two issues share context but don't block each other</p>
|
|
<pre><code class="lang-bash"># bd-20 and bd-18 are contextually related
|
|
bd dep add bd-20 bd-18 --type related
|
|
|
|
# Both can be worked on independently</code></pre>
|
|
<p><strong>Example Use Cases:</strong></p>
|
|
<ul><li>Frontend and backend for same feature</li><li>Documentation for related modules</li><li>Related bug fixes in same area</li><li>Alternative implementation approaches</li></ul>
|
|
<p><strong>Graph Representation:</strong></p>
|
|
<pre><code>bd-18 <--> bd-20 (bidirectional soft link)</code></pre>
|
|
<h3>3. <code>parent-child</code> - Hierarchy</h3>
|
|
<p><strong>Purpose:</strong> Creates epic/subtask relationships</p>
|
|
<p><strong>Use when:</strong> Organizing work into epics and subtasks</p>
|
|
<pre><code class="lang-bash"># bd-25 is a subtask of epic bd-22
|
|
bd dep add bd-25 bd-22 --type parent-child
|
|
|
|
# Parent: bd-22 (epic)
|
|
# Child: bd-25 (subtask)</code></pre>
|
|
<p><strong>Example Use Cases:</strong></p>
|
|
<ul><li>Feature epic with implementation subtasks</li><li>Large refactoring broken into steps</li><li>Release milestone with constituent tasks</li><li>Research spike with exploration tasks</li></ul>
|
|
<p><strong>Graph Representation:</strong></p>
|
|
<pre><code>bd-22 (epic)
|
|
├─ bd-25 (subtask)
|
|
├─ bd-26 (subtask)
|
|
└─ bd-27 (subtask)</code></pre>
|
|
<h3>4. <code>discovered-from</code> - Discovery Trail</h3>
|
|
<p><strong>Purpose:</strong> Tracks issues discovered during work on another issue</p>
|
|
<p><strong>Use when:</strong> You find new work during execution and want to maintain the discovery chain</p>
|
|
<pre><code class="lang-bash"># bd-30 was discovered while working on bd-28
|
|
bd dep add bd-30 bd-28 --type discovered-from
|
|
|
|
# Preserves discovery context</code></pre>
|
|
<p><strong>Example Use Cases:</strong></p>
|
|
<ul><li>Bug found during feature implementation</li><li>Edge case discovered during testing</li><li>Technical debt identified during refactoring</li><li>Missing documentation found during review</li></ul>
|
|
<p><strong>Graph Representation:</strong></p>
|
|
<pre><code>bd-28 (working on) --> bd-30 (discovered)</code></pre>
|
|
<h2>Dependency Commands</h2>
|
|
<h3>Add Dependency</h3>
|
|
<pre><code class="lang-bash"># General syntax
|
|
bd dep add <target-issue> <source-issue> --type <type>
|
|
|
|
# Examples
|
|
bd dep add bd-5 bd-3 --type blocks
|
|
bd dep add bd-10 bd-8 --type related
|
|
bd dep add bd-15 bd-12 --type parent-child
|
|
bd dep add bd-20 bd-18 --type discovered-from</code></pre>
|
|
<h3>Remove Dependency</h3>
|
|
<pre><code class="lang-bash">bd dep remove bd-5 bd-3 --type blocks</code></pre>
|
|
<h3>View Dependency Tree</h3>
|
|
<pre><code class="lang-bash"># Show all dependencies for an issue
|
|
bd dep tree bd-42
|
|
|
|
# Show specific dependency type
|
|
bd dep tree bd-42 --type blocks</code></pre>
|
|
<h3>Check for Cycles</h3>
|
|
<pre><code class="lang-bash"># Detect circular dependencies
|
|
bd dep cycles
|
|
|
|
# Beads prevents invalid cycles when adding dependencies</code></pre>
|
|
<h2>Practical Patterns</h2>
|
|
<h3>Pattern 1: Epic with Ordered Subtasks</h3>
|
|
<p>Create a feature epic with dependencies between subtasks:</p>
|
|
<pre><code class="lang-bash"># Create epic
|
|
bd create "Implement user authentication" -t epic -p 0 --json
|
|
# Returns: bd-100
|
|
|
|
# Create subtasks
|
|
bd create "Design auth schema" -t task -p 0 --json # bd-101
|
|
bd create "Implement JWT tokens" -t task -p 1 --json # bd-102
|
|
bd create "Add login endpoints" -t task -p 1 --json # bd-103
|
|
bd create "Add auth middleware" -t task -p 2 --json # bd-104
|
|
|
|
# Link to epic
|
|
bd dep add bd-101 bd-100 --type parent-child
|
|
bd dep add bd-102 bd-100 --type parent-child
|
|
bd dep add bd-103 bd-100 --type parent-child
|
|
bd dep add bd-104 bd-100 --type parent-child
|
|
|
|
# Chain dependencies
|
|
bd dep add bd-102 bd-101 --type blocks # JWT depends on schema
|
|
bd dep add bd-103 bd-102 --type blocks # Endpoints depend on JWT
|
|
bd dep add bd-104 bd-103 --type blocks # Middleware depends on endpoints
|
|
|
|
# Result: Linear workflow within epic
|
|
# bd ready will show: bd-101 (first unblocked)</code></pre>
|
|
<h3>Pattern 2: Discovery-Driven Development</h3>
|
|
<p>Track discovered work during execution:</p>
|
|
<pre><code class="lang-bash"># Working on refactoring
|
|
bd update bd-50 --status in_progress --json
|
|
|
|
# Discover issues during work
|
|
bd create "Fix user validation bug" -t bug -p 0 --json # bd-51
|
|
bd dep add bd-51 bd-50 --type discovered-from
|
|
|
|
bd create "Add missing user tests" -t task -p 2 --json # bd-52
|
|
bd dep add bd-52 bd-50 --type discovered-from
|
|
|
|
bd create "Update user documentation" -t task -p 3 --json # bd-53
|
|
bd dep add bd-53 bd-50 --type discovered-from
|
|
|
|
# Now you have discovery trail: bd-50 -> bd-51, bd-52, bd-53
|
|
# Can work on any discovered issue independently</code></pre>
|
|
<h3>Pattern 3: Parallel Features with Shared Dependency</h3>
|
|
<p>Multiple features depend on same foundation:</p>
|
|
<pre><code class="lang-bash"># Foundation
|
|
bd create "Build base API client" -t task -p 0 --json # bd-200
|
|
|
|
# Dependent features
|
|
bd create "User profile feature" -t feature -p 1 --json # bd-201
|
|
bd create "Settings feature" -t feature -p 1 --json # bd-202
|
|
bd create "Dashboard feature" -t feature -p 1 --json # bd-203
|
|
|
|
# All features blocked by foundation
|
|
bd dep add bd-201 bd-200 --type blocks
|
|
bd dep add bd-202 bd-200 --type blocks
|
|
bd dep add bd-203 bd-200 --type blocks
|
|
|
|
# Result: Complete bd-200, then all features become ready</code></pre>
|
|
<h3>Pattern 4: Related Work Clusters</h3>
|
|
<p>Group related issues without blocking:</p>
|
|
<pre><code class="lang-bash"># Create related issues
|
|
bd create "Frontend: User profile UI" -t task -p 1 --json # bd-300
|
|
bd create "Backend: User profile API" -t task -p 1 --json # bd-301
|
|
bd create "Docs: User profile guide" -t task -p 3 --json # bd-302
|
|
|
|
# Link as related (no blocking)
|
|
bd dep add bd-300 bd-301 --type related
|
|
bd dep add bd-300 bd-302 --type related
|
|
bd dep add bd-301 bd-302 --type related
|
|
|
|
# Result: All show as ready, can be worked on in any order
|
|
# But context is preserved between related issues</code></pre>
|
|
<h2>Dependency Queries</h2>
|
|
<h3>Find Blocked Issues</h3>
|
|
<pre><code class="lang-bash"># List issues that are blocked
|
|
bd list --status blocked --json
|
|
|
|
# Show what's blocking an issue
|
|
bd dep tree bd-50 | grep "blocks"</code></pre>
|
|
<h3>Find Ready Work</h3>
|
|
<pre><code class="lang-bash"># Ready work = no blocking dependencies
|
|
bd ready --json --limit 10
|
|
|
|
# Ready work for specific priority
|
|
bd ready --priority 0 --json</code></pre>
|
|
<h3>Trace Discovery Chain</h3>
|
|
<pre><code class="lang-bash"># Find all issues discovered from bd-X
|
|
bd dep tree bd-50 --type discovered-from</code></pre>
|
|
<h3>View Epic Progress</h3>
|
|
<pre><code class="lang-bash"># Show all subtasks of epic
|
|
bd dep tree bd-100 --type parent-child
|
|
|
|
# Filter by status
|
|
bd list --json | jq '.[] | select(.parent == "bd-100")'</code></pre>
|
|
<h2>Best Practices</h2>
|
|
<h3>Choosing Dependency Types</h3>
|
|
<pre><code>SITUATION → DEPENDENCY TYPE
|
|
─────────────────────────────────────────────────────────────
|
|
X must complete before Y can start → blocks
|
|
X and Y are related but independent → related
|
|
Y is subtask of epic X → parent-child
|
|
Y was discovered while working on X → discovered-from</code></pre>
|
|
<h3>Avoiding Cycles</h3>
|
|
<p>Beads prevents cycles in <code>blocks</code> dependencies, but be mindful:</p>
|
|
<pre><code class="lang-bash"># INVALID - creates cycle
|
|
bd dep add bd-10 bd-5 --type blocks
|
|
bd dep add bd-5 bd-10 --type blocks # Error: would create cycle
|
|
|
|
# VALID - use related instead
|
|
bd dep add bd-10 bd-5 --type related
|
|
bd dep add bd-5 bd-10 --type related</code></pre>
|
|
<h3>Dependency Hygiene</h3>
|
|
<ol><li><strong>Be specific:</strong> Use <code>blocks</code> only when truly necessary</li><li><strong>Avoid over-linking:</strong> Don't create dependencies "just in case"</li><li><strong>Update dependencies:</strong> Remove obsolete blockers</li><li><strong>Document reasoning:</strong> Use issue descriptions to explain dependencies</li><li><strong>Review regularly:</strong> Check <code>bd dep cycles</code> periodically</li></ol>
|
|
<h2>Common Pitfalls</h2>
|
|
<h3>Overusing <code>blocks</code></h3>
|
|
<p><strong>Problem:</strong> Everything blocks everything, nothing is ready</p>
|
|
<p><strong>Solution:</strong> Reserve <code>blocks</code> for hard dependencies. Use <code>related</code> for soft associations.</p>
|
|
<h3>Missing Discovery Links</h3>
|
|
<p><strong>Problem:</strong> Lose context of why work was created</p>
|
|
<p><strong>Solution:</strong> Always link discovered work with <code>discovered-from</code></p>
|
|
<h3>Orphaned Subtasks</h3>
|
|
<p><strong>Problem:</strong> Subtasks not linked to parent epic</p>
|
|
<p><strong>Solution:</strong> Always create <code>parent-child</code> link when breaking down epics</p>
|
|
<h2>Related Skills</h2>
|
|
<ul><li><code>beads-workflow.md</code> - Core bd CLI commands</li><li><code>beads-multi-session-patterns.md</code> - Using dependencies in long-horizon tasks</li><li><code>beads-context-strategies.md</code> - Preserving dependency context</li></ul>
|
|
<h2>References</h2>
|
|
<ul><li>See <code>beads-context/references/beads_cli_reference.md</code> for full <code>bd dep</code> command reference</li></ul>
|
|
<footer>
|
|
<div class="fmap">
|
|
<div><b>Build</b>
|
|
<a href="https://hanzo.app">hanzo.app</a> app builder
|
|
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
|
|
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
|
|
<div><b>Run</b>
|
|
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
|
|
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
|
|
<div><b>Account</b>
|
|
<a href="https://hanzo.id">hanzo.id</a> sign in
|
|
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
|
|
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
|
|
<div><b>Company</b>
|
|
<a href="https://hanzo.ai">hanzo.ai</a> canonical
|
|
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
|
|
</div>
|
|
<div class="fend"><a href="/beads-dependency-management.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
|
|
</footer>
|
|
</div></body></html> |