create-beads: add an independence heuristic for the epic-vs-single-bead choice#2
Open
fkberthold wants to merge 1 commit into
Open
create-beads: add an independence heuristic for the epic-vs-single-bead choice#2fkberthold wants to merge 1 commit into
fkberthold wants to merge 1 commit into
Conversation
create-beads framed the multi-task/small-feature split by size only. Add a short heuristic prompting the independence question (shared files / sequential dependency) at creation time, so independent work becomes sibling tasks under an epic that bd ready can surface in parallel, and coupled work stays a single bead. Tracked downstream as loom-7bn.
fkberthold
added a commit
to fkberthold/loom
that referenced
this pull request
May 29, 2026
…uristic upstream-a-bead canary (loom-k2g.7) — first end-to-end dogfood of the --issue+pr lane (doc-change framing, prose-only upstream). - Filed: pprice/beadpowers#2 (PR) + #1 (issue) — adds an epic-vs-single-bead independence heuristic to create-beads. - Watch-bead loom-7nq (upstream:watch, blocked-by loom-7bn) tracks the merge via /check-upstream-prs. - Closes work-bead loom-7bn, canary loom-k2g.7, AND the loom-k2g epic (all 7 children done; recipe validated). - Friction follow-ups: loom-bqz (prose-only sub-lane + trivial-PR inline escape) + loom-7f3 (install-invocability assertion). - Design source: drawer_loom_decisions_aa11fe3d98a3afe735853668. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
fkberthold
added a commit
to fkberthold/loom
that referenced
this pull request
May 29, 2026
…close loom-k2g epic
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a short "Epic or one bead?" heuristic to
create-beads(skills/create-beads/SKILL.md,## Structure).The existing Structure section frames the epic-vs-standalone choice by size ("Multi-task features" vs "Small features"). This adds the question that actually governs how the beads get worked — independence: are the candidate items independent (no shared files, no sequential dependency)?
bd readysurfaces them in parallel.Plus a "default to one bead when unsure" tie-breaker.
Closes #1.
Change
Six added lines in
skills/create-beads/SKILL.md, slotted between the "Small features" example and## Task Guidelines. Prose-only; matches the surrounding terse, example-led voice of the skill.Verification
beadpowers has no test harness (it's a markdown-skills plugin), so there's no automated test to add. Verified manually:
grep -i 'independ\|coupled\|sibling' skills/create-beads/SKILL.md→ no match (the heuristic was absent).git diff --stat→ 1 file, +6).Notes
loom-7bn.