Files
skills/public/beads-multi-session-patterns.html
zeekayandHanzo Dev 9e10c1c10e Each llms index points at the other two
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]>
2026-09-11 00:27:59 -07:00

453 lines
24 KiB
HTML

<!doctype html>
<html lang="en"><head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>beads-multi-session-patterns</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-multi-session-patterns.md">
<link rel="icon" href="/favicon.svg">
<link rel="canonical" href="https://hanzoskills.com/beads-multi-session-patterns">
</head>
<!-- Reading this with a machine? Every page here is also plain markdown.
This one: https://hanzoskills.com/beads-multi-session-patterns.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-multi-session-patterns</h1><p class="lede">Use this skill when: Working on complex tasks spanning multiple sessions, managing long-horizon work chains, or coordinating parallel work streams</p><h1>Beads Multi-Session Task Patterns</h1>
<p><strong>Use this skill when:</strong> Working on complex tasks spanning multiple sessions, managing long-horizon work chains, or coordinating parallel work streams</p>
<h2>Overview</h2>
<p>Beads excels at maintaining state across multiple sessions. This skill covers patterns for breaking down complex work into manageable chains that persist across days, weeks, or months.</p>
<h2>Long-Horizon Task Chain Pattern</h2>
<p>For complex multi-step workflows:</p>
<h3>Step 1: Create Epic and Subtasks</h3>
<pre><code class="lang-bash"># Create parent epic
bd create &quot;Implement user authentication&quot; -t epic -p 0 --json
# Returns: bd-100
# Create ordered subtasks
bd create &quot;Design auth schema&quot; -t task -p 0 --json # bd-101
bd create &quot;Implement JWT tokens&quot; -t task -p 1 --json # bd-102
bd create &quot;Add login endpoints&quot; -t task -p 1 --json # bd-103
bd create &quot;Add auth middleware&quot; -t task -p 2 --json # bd-104
bd create &quot;Write auth tests&quot; -t task -p 2 --json # bd-105</code></pre>
<h3>Step 2: Build Dependency Chain</h3>
<pre><code class="lang-bash"># Link all to epic
for id in 101 102 103 104 105; do
bd dep add bd-$id bd-100 --type parent-child
done
# Chain sequential dependencies
bd dep add bd-102 bd-101 --type blocks # JWT needs schema
bd dep add bd-103 bd-102 --type blocks # Endpoints need JWT
bd dep add bd-104 bd-103 --type blocks # Middleware needs endpoints
bd dep add bd-105 bd-104 --type blocks # Tests need middleware</code></pre>
<h3>Step 3: Work Session by Session</h3>
<pre><code class="lang-bash"># Session 1
bd ready --json # Shows: bd-101 (design schema)
bd update bd-101 --status in_progress --json
# ... work on schema ...
bd close bd-101 --reason &quot;Schema designed and documented&quot; --json
bd export -o .beads/issues.jsonl
git add .beads/issues.jsonl &amp;&amp; git commit -m &quot;Complete bd-101: auth schema&quot;
# Session 2 (days later)
bd import -i .beads/issues.jsonl
bd ready --json # Shows: bd-102 (implement JWT) - unblocked!
bd update bd-102 --status in_progress --json
# ... work continues ...</code></pre>
<h3>Step 4: Context Management Strategy</h3>
<pre><code class="lang-bash"># At session start: Load full tree
bd dep tree bd-100
/context &quot;Auth epic bd-100: 5 subtasks, currently on bd-102 (JWT implementation), completed: bd-101 (schema), remaining: 3 tasks&quot;
# Between sessions: Compact to essentials
/compact &quot;Preserve: epic bd-100 progress (2/5 complete), current task bd-102, next tasks [bd-103, bd-104, bd-105]. Remove: completed task details&quot;</code></pre>
<h2>Discovery-Driven Pattern</h2>
<p>For exploratory work where scope emerges during execution:</p>
<h3>Workflow</h3>
<pre><code class="lang-bash"># Start with single task
bd create &quot;Refactor user service&quot; -t task -p 1 --json # bd-200
bd update bd-200 --status in_progress --json
# Discover issues during work
bd create &quot;Fix user validation bug&quot; -t bug -p 0 --json # bd-201
bd dep add bd-201 bd-200 --type discovered-from
bd create &quot;Add missing user tests&quot; -t task -p 2 --json # bd-202
bd dep add bd-202 bd-200 --type discovered-from
bd create &quot;Update user docs&quot; -t task -p 3 --json # bd-203
bd dep add bd-203 bd-200 --type discovered-from
# Context preservation
/context &quot;Discovered from bd-200: bd-201 (validation bug, must fix), bd-202 (tests, can defer), bd-203 (docs, low priority). Will address in order P0, P1, P2, P3&quot;
# Work prioritized discovered issues
bd update bd-201 --status in_progress --json
# ... fix bug ...
bd close bd-201 --reason &quot;Fixed validation for edge case X&quot; --json
# Eventually close parent
bd close bd-200 --reason &quot;Refactored + addressed discovered issues&quot; --json</code></pre>
<h3>Context Strategy</h3>
<pre><code class="lang-bash"># After discovering 3+ issues
/context &quot;Discovery chain from bd-200: [list with priorities and brief descriptions], plan to address in priority order&quot;
# When completing parent with discoveries still open
bd close bd-200 --reason &quot;Main refactoring complete, discovered issues tracked separately&quot; --json
/compact &quot;Preserve: bd-200 complete, spawned issues [bd-201: closed, bd-202: open, bd-203: open]. Remove: refactoring implementation details&quot;</code></pre>
<h2>Parallel Work Streams Pattern</h2>
<p>For coordinating multiple independent streams:</p>
<h3>Setup</h3>
<pre><code class="lang-bash"># Stream 1: Frontend work
bd create &quot;Frontend Epic&quot; -t epic -p 1 --json # bd-300
bd create &quot;User profile UI&quot; -t task -p 1 --json # bd-301
bd create &quot;Settings UI&quot; -t task -p 1 --json # bd-302
bd dep add bd-301 bd-300 --type parent-child
bd dep add bd-302 bd-300 --type parent-child
# Stream 2: Backend work
bd create &quot;Backend Epic&quot; -t epic -p 1 --json # bd-310
bd create &quot;User profile API&quot; -t task -p 1 --json # bd-311
bd create &quot;Settings API&quot; -t task -p 1 --json # bd-312
bd dep add bd-311 bd-310 --type parent-child
bd dep add bd-312 bd-310 --type parent-child
# Stream 3: Infrastructure
bd create &quot;Infrastructure Epic&quot; -t epic -p 0 --json # bd-320
bd create &quot;Deploy staging&quot; -t task -p 0 --json # bd-321
bd create &quot;Set up monitoring&quot; -t task -p 1 --json # bd-322
bd dep add bd-321 bd-320 --type parent-child
bd dep add bd-322 bd-320 --type parent-child
# Cross-stream dependencies
bd dep add bd-301 bd-311 --type blocks # UI needs API
bd dep add bd-302 bd-312 --type blocks # Settings UI needs API</code></pre>
<h3>Multi-Session Execution</h3>
<pre><code class="lang-bash"># Session 1: Infrastructure focus
bd ready --json # Shows: bd-321 (deploy staging)
bd update bd-321 --status in_progress --json
# ... deploy ...
bd close bd-321 --reason &quot;Staging deployed&quot; --json
/context &quot;Completed bd-321 (staging), next: bd-322 (monitoring). Frontend/backend work still blocked on APIs&quot;
# Session 2: Backend focus
bd ready --json # Shows: bd-311, bd-312 (APIs now unblocked)
bd update bd-311 --status in_progress --json
# ... implement API ...
bd close bd-311 --reason &quot;Profile API complete&quot; --json
/context &quot;Completed bd-311 (profile API), unblocked: bd-301 (profile UI). Next: bd-312 or bd-301&quot;
# Session 3: Frontend + Backend in parallel
bd ready --json # Shows: bd-301 (UI), bd-312 (settings API), bd-322 (monitoring)
# Pick bd-301 (frontend)
bd update bd-301 --status in_progress --json
# ... work ...</code></pre>
<h3>Context Strategy</h3>
<pre><code class="lang-bash"># Track progress across epics
/context &quot;Epic status: Frontend 1/2 (bd-301 in progress), Backend 1/2 (bd-311 done, bd-312 ready), Infrastructure 1/2 (bd-321 done, bd-322 ready)&quot;
# When switching streams
/context &quot;Switching: Frontend (bd-301) paused at [state] -&gt; Backend (bd-312) starting with [plan]&quot;</code></pre>
<h2>Merge Conflict Pattern</h2>
<p>For handling concurrent work in different branches:</p>
<h3>Scenario</h3>
<pre><code class="lang-bash"># Branch A creates: bd-400, bd-401, bd-402
# Branch B creates: bd-400, bd-401, bd-403 (collision on IDs!)
# Both branches merged to main</code></pre>
<h3>Resolution</h3>
<pre><code class="lang-bash"># After merge conflict in .beads/issues.jsonl
git merge feature-branch
# Conflict in .beads/issues.jsonl
# Preview collision
bd import -i .beads/issues.jsonl --dry-run
# Auto-resolve with remapping
bd import -i .beads/issues.jsonl --resolve-collisions
# Document resolution
/context &quot;Merge resolved: Branch A bd-400-&gt;bd-404, bd-401-&gt;bd-405. Branch B kept bd-400, bd-401. All dependencies preserved. Verified: bd dep cycles returns clean&quot;
# Export clean state
bd export -o .beads/issues.jsonl
git add .beads/issues.jsonl
git commit -m &quot;Resolve Beads merge conflict&quot;</code></pre>
<h2>Multi-Agent Coordination Pattern</h2>
<p>For parallel work by multiple agents/developers:</p>
<h3>Setup</h3>
<pre><code class="lang-bash"># Agent 1 claims backend work
bd ready --json
bd update bd-500 --status in_progress --assignee agent-1 --json
# Agent 2 claims frontend work
bd ready --assignee agent-2 --json
bd update bd-501 --status in_progress --assignee agent-2 --json</code></pre>
<h3>Synchronization</h3>
<pre><code class="lang-bash"># Agent 1 workflow
# ... work ...
bd close bd-500 --reason &quot;API complete&quot; --json
bd export -o .beads/issues.jsonl
git add .beads/issues.jsonl
git commit -m &quot;Agent 1: Complete bd-500&quot;
git push
# Agent 2 workflow (parallel)
# ... work ...
bd close bd-501 --reason &quot;UI complete&quot; --json
bd export -o .beads/issues.jsonl
git add .beads/issues.jsonl
git commit -m &quot;Agent 2: Complete bd-501&quot;
git pull # Might have conflicts
bd import -i .beads/issues.jsonl --resolve-collisions
git push</code></pre>
<h3>Context Strategy</h3>
<pre><code class="lang-bash"># Each agent maintains separate context
# Agent 1:
/context &quot;Agent 1 perspective: working on backend epic bd-500, completed API endpoints, next: bd-502 (database migration)&quot;
# Agent 2:
/context &quot;Agent 2 perspective: working on frontend epic bd-501, waiting on bd-500 completion, next: bd-503 (integration)&quot;</code></pre>
<h2>Best Practices for Long-Horizon Work</h2>
<h3>1. Progressive Refinement</h3>
<p>Start broad, refine as you go:</p>
<pre><code class="lang-bash"># Week 1: Create epic and high-level tasks
bd create &quot;Build payment system&quot; -t epic -p 0 --json # bd-600
# Week 2: Break down first task
bd create &quot;Design payment schema&quot; -t task -p 0 --json # bd-601
bd dep add bd-601 bd-600 --type parent-child
# Week 3: Discover subtasks during implementation
bd create &quot;Add Stripe integration&quot; -t task -p 1 --json # bd-602
bd dep add bd-602 bd-601 --type discovered-from</code></pre>
<h3>2. Milestone Tracking</h3>
<p>Use epics as milestones:</p>
<pre><code class="lang-bash"># Quarterly milestones
bd create &quot;Q1 2025: Core Features&quot; -t epic -p 0 --json
bd create &quot;Q2 2025: Performance&quot; -t epic -p 1 --json
bd create &quot;Q3 2025: Scale &amp; Deploy&quot; -t epic -p 2 --json</code></pre>
<h3>3. Session Continuity</h3>
<p>Always end sessions cleanly:</p>
<pre><code class="lang-bash"># End of session
bd export -o .beads/issues.jsonl
/context &quot;Session end: completed [bd-X, bd-Y], in progress [bd-Z at 70%], next session: finish bd-Z, start bd-W&quot;
git add .beads/issues.jsonl
git commit -m &quot;Session end: progress update&quot;</code></pre>
<h3>4. Dependency Audits</h3>
<p>Periodically review dependency health:</p>
<pre><code class="lang-bash"># Check for cycles
bd dep cycles
# Review blocked issues
bd list --status blocked --json | jq &#x27;.[] | {id, title, blocked_by}&#x27;
# Clean up stale dependencies
bd dep remove bd-OLD bd-STALE --type blocks</code></pre>
<h2>Related Skills</h2>
<ul><li><code>beads-workflow.md</code> - Core bd commands</li><li><code>beads-dependency-management.md</code> - Dependency patterns</li><li><code>beads-context-strategies.md</code> - Context management for long sessions</li></ul>
<h2>References</h2>
<ul><li>See <code>beads-context/references/context_examples.md</code> for real multi-session examples</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-multi-session-patterns.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
</footer>
</div></body></html>