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]>
453 lines
24 KiB
HTML
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 "Implement user authentication" -t epic -p 0 --json
|
|
# Returns: bd-100
|
|
|
|
# Create ordered 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
|
|
bd create "Write auth tests" -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 "Schema designed and documented" --json
|
|
bd export -o .beads/issues.jsonl
|
|
git add .beads/issues.jsonl && git commit -m "Complete bd-101: auth schema"
|
|
|
|
# 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 "Auth epic bd-100: 5 subtasks, currently on bd-102 (JWT implementation), completed: bd-101 (schema), remaining: 3 tasks"
|
|
|
|
# Between sessions: Compact to essentials
|
|
/compact "Preserve: epic bd-100 progress (2/5 complete), current task bd-102, next tasks [bd-103, bd-104, bd-105]. Remove: completed task details"</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 "Refactor user service" -t task -p 1 --json # bd-200
|
|
bd update bd-200 --status in_progress --json
|
|
|
|
# Discover issues during work
|
|
bd create "Fix user validation bug" -t bug -p 0 --json # bd-201
|
|
bd dep add bd-201 bd-200 --type discovered-from
|
|
|
|
bd create "Add missing user tests" -t task -p 2 --json # bd-202
|
|
bd dep add bd-202 bd-200 --type discovered-from
|
|
|
|
bd create "Update user docs" -t task -p 3 --json # bd-203
|
|
bd dep add bd-203 bd-200 --type discovered-from
|
|
|
|
# Context preservation
|
|
/context "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"
|
|
|
|
# Work prioritized discovered issues
|
|
bd update bd-201 --status in_progress --json
|
|
# ... fix bug ...
|
|
bd close bd-201 --reason "Fixed validation for edge case X" --json
|
|
|
|
# Eventually close parent
|
|
bd close bd-200 --reason "Refactored + addressed discovered issues" --json</code></pre>
|
|
<h3>Context Strategy</h3>
|
|
<pre><code class="lang-bash"># After discovering 3+ issues
|
|
/context "Discovery chain from bd-200: [list with priorities and brief descriptions], plan to address in priority order"
|
|
|
|
# When completing parent with discoveries still open
|
|
bd close bd-200 --reason "Main refactoring complete, discovered issues tracked separately" --json
|
|
/compact "Preserve: bd-200 complete, spawned issues [bd-201: closed, bd-202: open, bd-203: open]. Remove: refactoring implementation details"</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 "Frontend Epic" -t epic -p 1 --json # bd-300
|
|
bd create "User profile UI" -t task -p 1 --json # bd-301
|
|
bd create "Settings UI" -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 "Backend Epic" -t epic -p 1 --json # bd-310
|
|
bd create "User profile API" -t task -p 1 --json # bd-311
|
|
bd create "Settings API" -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 "Infrastructure Epic" -t epic -p 0 --json # bd-320
|
|
bd create "Deploy staging" -t task -p 0 --json # bd-321
|
|
bd create "Set up monitoring" -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 "Staging deployed" --json
|
|
/context "Completed bd-321 (staging), next: bd-322 (monitoring). Frontend/backend work still blocked on APIs"
|
|
|
|
# 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 "Profile API complete" --json
|
|
/context "Completed bd-311 (profile API), unblocked: bd-301 (profile UI). Next: bd-312 or bd-301"
|
|
|
|
# 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 "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)"
|
|
|
|
# When switching streams
|
|
/context "Switching: Frontend (bd-301) paused at [state] -> Backend (bd-312) starting with [plan]"</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 "Merge resolved: Branch A bd-400->bd-404, bd-401->bd-405. Branch B kept bd-400, bd-401. All dependencies preserved. Verified: bd dep cycles returns clean"
|
|
|
|
# Export clean state
|
|
bd export -o .beads/issues.jsonl
|
|
git add .beads/issues.jsonl
|
|
git commit -m "Resolve Beads merge conflict"</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 "API complete" --json
|
|
bd export -o .beads/issues.jsonl
|
|
git add .beads/issues.jsonl
|
|
git commit -m "Agent 1: Complete bd-500"
|
|
git push
|
|
|
|
# Agent 2 workflow (parallel)
|
|
# ... work ...
|
|
bd close bd-501 --reason "UI complete" --json
|
|
bd export -o .beads/issues.jsonl
|
|
git add .beads/issues.jsonl
|
|
git commit -m "Agent 2: Complete bd-501"
|
|
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 "Agent 1 perspective: working on backend epic bd-500, completed API endpoints, next: bd-502 (database migration)"
|
|
|
|
# Agent 2:
|
|
/context "Agent 2 perspective: working on frontend epic bd-501, waiting on bd-500 completion, next: bd-503 (integration)"</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 "Build payment system" -t epic -p 0 --json # bd-600
|
|
|
|
# Week 2: Break down first task
|
|
bd create "Design payment schema" -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 "Add Stripe integration" -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 "Q1 2025: Core Features" -t epic -p 0 --json
|
|
bd create "Q2 2025: Performance" -t epic -p 1 --json
|
|
bd create "Q3 2025: Scale & Deploy" -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 "Session end: completed [bd-X, bd-Y], in progress [bd-Z at 70%], next session: finish bd-Z, start bd-W"
|
|
git add .beads/issues.jsonl
|
|
git commit -m "Session end: progress update"</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 '.[] | {id, title, blocked_by}'
|
|
|
|
# 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> |