bmad-code-org/bmad-loop

Automate the BMad Dev Cycle

Stars: 137
Forks: 60
Open beginner issues: 15
Indexed issues: 129
Avg merge: 2d 13h
Merged PRs (30d): 45

Dominant language: Python
License: No license data
Last GitHub push: Sep 17, 2026
Latest indexed: Sep 20, 2026
Contributing guide: Contributing guide
Code of conduct: Code of conduct
Beginner labels: good first issue help wanted

Beginner friendly Everything

Open All

123 open issues indexed

sweep: status and state.json report policy.toml's [sweep] values, not the run's effective options Open

area:config area:deferred-work bug P3

Difficulty 3/5 1-2 days Newbie friendliness 65/100

bmad-code-org/bmad-loop#815 · Opened Sep 20, 2026
Remove legacy review.on_status_contradiction = "retry" mode Open

area:config enhancement P3

Difficulty 3/5 1-2 days Newbie friendliness 74/100

bmad-code-org/bmad-loop#813 · Opened Sep 17, 2026
Remove deprecated [engine] compatibility block in policy.py Open

area:config enhancement P3

Difficulty 3/5 1-2 days Newbie friendliness 76/100

bmad-code-org/bmad-loop#810 · Opened Sep 17, 2026
untracked_files reads ls-files without -z, so a non-ASCII untracked path comes back C-quoted — the rollback safety-net snapshot then fails its own git add and halts the run Open

area:engine bug P2

Difficulty 3/5 1-2 days Newbie friendliness 78/100

bmad-code-org/bmad-loop#783 · Opened Sep 14, 2026
no-artifact with no hint when story specs live in a subfolder (non-recursive artifact glob) Open

area:adapters enhancement good first issue P3

Difficulty 2/5 1-3 hours Newbie friendliness 76/100

bmad-code-org/bmad-loop#780 · 2 comments · Opened Sep 13, 2026
[BUG] post_story declarative hooks never run: cwd is the worktree that unit-merged just deleted Open

area:engine bug P2

Difficulty 3/5 1-2 days Newbie friendliness 74/100

bmad-code-org/bmad-loop#779 · Opened Sep 11, 2026
Timed-out sessions are journalled with tokens: 0, hiding the most expensive sessions from status, metrics and max_tokens_per_story Open

area:adapters bug needs-design P3

Difficulty 4/5 3-5 days Newbie friendliness 55/100

bmad-code-org/bmad-loop#778 · 1 comment · Opened Sep 10, 2026
Retry after rollback-auto never names the attempt-preserve-dirty snapshot, so attempt 2 rebuilds attempt 1 from scratch Open

area:engine enhancement needs-design P3

Difficulty 3/5 1-2 days Newbie friendliness 68/100

bmad-code-org/bmad-loop#777 · 2 comments · 1 reaction · Opened Sep 10, 2026
dev.on_timeout salvage-if-done: a timed-out dev session with a finished, gate-green product is retried and then deferred like an empty one Open

area:engine enhancement needs-design P3

Difficulty 4/5 3-5 days Newbie friendliness 55/100

bmad-code-org/bmad-loop#776 · 1 comment · Opened Sep 10, 2026
codex: usage is never captured in a real run (tokens: null) because the Stop hook payload has no transcript_path — read_usage() returns before the codex-rollout parser runs Open

area:adapters bug P2

Difficulty 4/5 3-5 days Newbie friendliness 70/100

bmad-code-org/bmad-loop#775 · Opened Sep 9, 2026
[BUG] Native Windows: hook relay command is shell-mangled, so no session event ever fires Open

area:adapters bug P2

Difficulty 3/5 1-2 days Newbie friendliness 68/100

bmad-code-org/bmad-loop#773 · 1 comment · Opened Sep 8, 2026
[BUG] Review session deadlocks when the orchestrator-owned deferred-work ledger is dirty at finalization Open

area:engine bug needs-design P3

Difficulty 4/5 3-5 days Newbie friendliness 55/100

bmad-code-org/bmad-loop#772 · Opened Sep 7, 2026
init: relay-script, fallback policy and .gitignore writes in install_into are not confined to the project (junction/symlink escape), unlike the hook-config and skill-tree writes Open

area:config bug P2

Difficulty 3/5 1-2 days Newbie friendliness 72/100

bmad-code-org/bmad-loop#771 · Opened Sep 7, 2026
Support global / user-level skill trees (e.g. ~/.agents/skills), not just project-relative Open

area:config enhancement needs-design P3

Difficulty 4/5 3-5 days Newbie friendliness 55/100

bmad-code-org/bmad-loop#770 · Opened Sep 7, 2026
[BUG] bmad-loop 0.11.1 validate fails against a `bmad setup` (BMAD 6.12) install Open

area:config bug duplicate

Difficulty 4/5 3-5 days Newbie friendliness 55/100

bmad-code-org/bmad-loop#769 · 1 comment · 1 reaction · Opened Sep 7, 2026
[BUG] validate/run blocked on BMAD-METHOD 6.13: skills moved to Claude Code plugins, and two required review skills no longer exist Open

area:adapters area:config bug needs-design P2

Difficulty 4/5 3-5 days Newbie friendliness 55/100

bmad-code-org/bmad-loop#768 · 1 comment · Opened Sep 5, 2026
[BUG] validate does not diagnose a malformed plugin manifest that every run then rejects Open

enhancement good first issue P3

Difficulty 3/5 1-2 days Newbie friendliness 78/100

bmad-code-org/bmad-loop#765 · Opened Sep 4, 2026
A late transient 5xx classifies a fully productive dev session as an environment fault, pausing the run instead of retrying Open

area:adapters area:engine bug needs-design P2

Difficulty 4/5 3-5 days Newbie friendliness 52/100

bmad-code-org/bmad-loop#764 · Opened Sep 4, 2026
narrow the removal guard's documented ceiling once a psmux release carries the psmux#622 fix Open

area:psmux blocked:upstream P4

Difficulty 3/5 1-2 days Newbie friendliness 55/100

bmad-code-org/bmad-loop#754 · Opened Sep 1, 2026
sweep discards a validating result.json unread on any non-completed status; zero-hook-event runs pass run/sweep untouched Open

area:deferred-work bug needs-design P3

Difficulty 4/5 3-5 days Newbie friendliness 55/100

bmad-code-org/bmad-loop#752 · Opened Aug 31, 2026
TUI: a recorded ctl-window id is a handle, not an identity - a reused window id readmits an untagged neighbour Open

area:psmux area:tui needs-design P4

Difficulty 4/5 3-5 days Newbie friendliness 48/100

bmad-code-org/bmad-loop#750 · Opened Aug 30, 2026
Doctrine gap: observation degrades that fold faults into benign values must be visible (class + audit) Open

area:adapters area:engine documentation enhancement needs-design P3

Difficulty 4/5 3-5 days Newbie friendliness 48/100

bmad-code-org/bmad-loop#747 · Opened Aug 28, 2026
needs-design: act-gated LLM pane-state classifier for the in-session states no structured channel covers (#727/#739/#680 residual) Open

area:adapters area:engine enhancement needs-design P3

Difficulty 5/5 Over a week Newbie friendliness 25/100

bmad-code-org/bmad-loop#746 · Opened Aug 28, 2026
Adopt structured session-state hook events (permission_prompt, idle_prompt, quota) ahead of pane heuristics Open

area:adapters area:engine enhancement needs-design P2

Difficulty 5/5 Over a week Newbie friendliness 35/100

bmad-code-org/bmad-loop#745 · 1 comment · Opened Aug 28, 2026
`adapter.extra_args` replaces `bypass_args` rather than extending it, so setting it for any other flag silently drops the permission bypass Open

area:adapters area:config bug P2

Difficulty 4/5 3-5 days Newbie friendliness 62/100

bmad-code-org/bmad-loop#740 · Opened Aug 27, 2026
The stall wake-nudge types text and presses Enter into the pane, so a session parked on a permission prompt gets that prompt answered Open

area:adapters bug P2

Difficulty 5/5 Over a week Newbie friendliness 35/100

bmad-code-org/bmad-loop#739 · Opened Aug 27, 2026
tmux/psmux: the session's initial window is created with no `-n`, so it is the only window bmad-loop does not name Open

area:adapters area:psmux enhancement good first issue P4

Difficulty 3/5 1-2 days Newbie friendliness 86/100

bmad-code-org/bmad-loop#738 · Opened Aug 27, 2026
retire the per-registry control-session name once a psmux release carries the psmux#599 fix Open

area:psmux blocked:upstream P4

Difficulty 4/5 3-5 days Newbie friendliness 38/100

bmad-code-org/bmad-loop#733 · Opened Aug 26, 2026
a stale multiplexer server substitutes its own `BMAD_LOOP_STATE_DIR` into every window it spawns Open

area:psmux needs-design P4

Difficulty 4/5 3-5 days Newbie friendliness 35/100

bmad-code-org/bmad-loop#731 · 1 comment · Opened Aug 26, 2026
psmux: decide whether bmad-loop should support `PSMUX_BARE_ENV` Open

area:psmux needs-design P4

Difficulty 5/5 Over a week Newbie friendliness 25/100

bmad-code-org/bmad-loop#730 · 1 comment · Opened Aug 26, 2026
psmux registry: decide what an operator's own `PSMUX_DATA_DIR` should mean Open

area:psmux needs-design P4

Difficulty 5/5 Over a week Newbie friendliness 35/100

bmad-code-org/bmad-loop#729 · 1 comment · Opened Aug 26, 2026
A dev session waiting on an interactive permission prompt is recorded as `crashed`, and `retry` burns the last attempt Open

area:adapters area:engine bug needs-design P2

Difficulty 4/5 3-5 days Newbie friendliness 48/100

bmad-code-org/bmad-loop#727 · 3 comments · Opened Aug 26, 2026
install: the rollback's sibling-scan decline claims a flag it may never have set Open

area:engine bug P3

Difficulty 2/5 1-3 hours Newbie friendliness 84/100

bmad-code-org/bmad-loop#723 · Opened Aug 25, 2026
sweep --archive: two-file archive move has no durable rename ordering (power loss can leave stubs without bodies) Open

area:deferred-work bug P2

Difficulty 5/5 Over a week Newbie friendliness 30/100

bmad-code-org/bmad-loop#715 · Opened Aug 25, 2026
release: the publish lost-race swallow does not verify the remote tag's target Open

bug P3

Difficulty 4/5 3-5 days Newbie friendliness 52/100

bmad-code-org/bmad-loop#704 · Opened Aug 23, 2026
Hard stop cannot interrupt blocking post-session work on native Windows (file channel has no signal-path equivalent) Open

area:engine bug needs-design P3

Difficulty 5/5 Over a week Newbie friendliness 38/100

bmad-code-org/bmad-loop#698 · 1 comment · Opened Aug 23, 2026
Consolidate runs.liveness and runs.engine_liveness into one tri-state reader Open

area:engine enhancement P4

Difficulty 3/5 1-2 days Newbie friendliness 67/100

bmad-code-org/bmad-loop#690 · Opened Aug 22, 2026
Protect the deferred-work ledger only when the task can actually carry it Open

area:engine bug P3

Difficulty 4/5 3-5 days Newbie friendliness 48/100

bmad-code-org/bmad-loop#687 · Opened Aug 21, 2026
The board carry's ownership proof is a TOCTOU: an edit between the check and `git add` still enters the commit Open

area:engine bug P3

Difficulty 5/5 Over a week Newbie friendliness 35/100

bmad-code-org/bmad-loop#686 · 1 comment · Opened Aug 21, 2026
harvest carry sweeps operator dirt into its own commit when inflight recovery re-enters _defer Open

Difficulty 4/5 3-5 days Newbie friendliness 50/100

bmad-code-org/bmad-loop#684 · Opened Aug 21, 2026
Re-cut test_merge_stray_dirt_escalates_with_clear_message to pin the hazard-first refusal lead-in Open

area:engine bug P3

Difficulty 2/5 1-3 hours Newbie friendliness 87/100

bmad-code-org/bmad-loop#683 · Opened Aug 21, 2026
An UNTRACKED, non-ignored board or ledger is committed whole by the post-merge carry, operator content included — deliberately left unprotected by #618 Open

area:engine bug needs-design P3

Difficulty 5/5 Over a week Newbie friendliness 35/100

bmad-code-org/bmad-loop#682 · Opened Aug 21, 2026
clean_incoming_collisions silently reverts an operator's uncommitted edit to a tracked path INSIDE the branch's incoming set Open

area:engine bug P2

Difficulty 4/5 3-5 days Newbie friendliness 45/100

bmad-code-org/bmad-loop#681 · Opened Aug 21, 2026
[BUG] Stall detection cannot see a session idling inside a tool call: pane-log re-arm keeps the grace alive through `sleep` Open

area:adapters area:tui enhancement needs-design P3

Difficulty 5/5 Over a week Newbie friendliness 48/100

bmad-code-org/bmad-loop#680 · 1 comment · Opened Aug 21, 2026
`StoryTask.from_dict` ingests `state.json`'s `baseline_commit` unvalidated — a symbolic value reaches the orchestrator's `git reset --hard` Open

area:engine bug P3

Difficulty 3/5 1-2 days Newbie friendliness 68/100

bmad-code-org/bmad-loop#677 · Opened Aug 20, 2026
Two concurrent unattended runs preceded a machine hang (Kernel-Power 41, no bugcheck) — original autorename diagnosis retracted, see correction Open

area:adapters area:psmux bug P4

Difficulty 2/5 1-3 hours Newbie friendliness 76/100

bmad-code-org/bmad-loop#673 · 7 comments · 1 reaction · Opened Aug 20, 2026
test(tui): nothing pins _poll's exclusive/group worker decoration Open

area:tui enhancement P4

Difficulty 2/5 1-3 hours Newbie friendliness 76/100

bmad-code-org/bmad-loop#666 · 1 comment · 1 reaction · Opened Aug 19, 2026
test: the git-maintenance guard can read green from an ambient system gitconfig Open

bug P4

Difficulty 2/5 1-3 hours Newbie friendliness 78/100

bmad-code-org/bmad-loop#665 · 2 comments · 1 reaction · Opened Aug 19, 2026
test: the git-maintenance suppression is template-scoped, so clones re-arm the detached daemon Open

bug P3

Difficulty 4/5 3-5 days Newbie friendliness 55/100

bmad-code-org/bmad-loop#664 · 1 comment · 1 reaction · Opened Aug 19, 2026
psmux 3.3.8 -> 3.3.9 adoption: umbrella for the floor bump, workaround retirement, and the follow-on tracks Open

area:psmux enhancement P4

Difficulty 5/5 Over a week Newbie friendliness 25/100

bmad-code-org/bmad-loop#660 · 3 comments · 1 reaction · Opened Aug 19, 2026

A short digest of beginner-friendly GitHub issues.