Skip to content

create-beads: add an independence heuristic for the epic-vs-single-bead choice#2

Open
fkberthold wants to merge 1 commit into
pprice:mainfrom
fkberthold:loom-7bn-splitting-heuristic
Open

create-beads: add an independence heuristic for the epic-vs-single-bead choice#2
fkberthold wants to merge 1 commit into
pprice:mainfrom
fkberthold:loom-7bn-splitting-heuristic

Conversation

@fkberthold

Copy link
Copy Markdown

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)?

  • Independent → sibling tasks under one epic, so bd ready surfaces them in parallel.
  • Coupled → a single bead with steps, to avoid manufacturing dependency edges.

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:

  • Before: grep -i 'independ\|coupled\|sibling' skills/create-beads/SKILL.md → no match (the heuristic was absent).
  • After: the subsection is present and reads coherently in context; the rest of the skill is unchanged (git diff --stat → 1 file, +6).

Notes

  • Commit style follows the repo's existing plain-imperative convention (no conventional-commits prefix, no sign-off observed in history).
  • Tracked downstream as loom-7bn.

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
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

create-beads: add an independence heuristic for the epic-vs-single-bead choice

1 participant