skills.rest
jongensutrecht
jongensutrechtCOMMUNITY
Explore all skills by this author →
GitHub

bmad-codex-general

Coordinates BMAD execution for Claude Code in repositories with BMAD runner support.

1|Updated Jan 13, 2026
Search Tags:#worktrees#claude-code#quality-gates#bmad#repo-governance#proof-gate
One-click install
npx skills add https://github.com/jongensutrecht/demo-ai-stack --skill bmad-codex-general
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-codex-general
Source: https://github.com/jongensutrecht/demo-ai-stack/tree/main/skills/bmad-codex-general
Command: npx skills add https://github.com/jongensutrecht/demo-ai-stack --skill bmad-codex-general

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you execute BMAD development work in a repo-agnostic, traceable, and fail-closed way without accidentally merging changes into the wrong branch or skipping required checks.

Core Features & Use Cases

  • Plan-to-implementation workflow: Converts a plan into BMAD input, generates stories, and drives implementation through isolated worktrees.
  • Governance and verification: Enforces repo policy checks, primary quality gates, and mandatory proof artifacts before merge.
  • Safe multi-story delivery: Supports story-by-story worktrees, handoff discipline for long runs, and controlled merges into a dedicated merge worktree.

Quick Start

Use this skill to run a BMAD session in a repository that contains scripts/bmad_bundle.py and follow its guarded worktree-based workflow from planning through proof and merge.

Frequently Asked Questions about bmad-codex-general

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run BMAD workflows safely in isolated git worktrees using Claude Code?▼

You can run BMAD workflows safely by using this Skill to coordinate plan-to-implementation execution in isolated worktrees, enforcing quality gates and proof artifacts before any merge occurs.

What is a proof-gated verification workflow for multi-story development?▼

Proof-gated verification requires mandatory proof artifacts and quality gate checks to pass before a worktree merge is allowed. It ensures fail-closed, traceable delivery by blocking completion until all repository policy checks are satisfied.

Do I need a specific script to execute BMAD sessions with Claude Code?▼

Yes, you need scripts/bmad_bundle.py present in the repository. This Skill requires that BMAD runner to execute planning, story generation, and worktree-based implementation under repository governance.

Can I use this BMAD workflow in any repository or does it require specific setup?▼

The workflow is repo-agnostic but requires the repository to provide the BMAD runner, use origin/main as the base branch, and enforce mandatory quality gates when present for controlled merges.

Why does my BMAD worktree merge fail before completion?▼

Merges fail-closed when required quality gates or mandatory proof artifacts are missing. The workflow enforces repository governance rules and blocks merges until all checks pass and final proof artifacts are produced.

What's the best way to manage long-running BMAD development sessions across multiple stories?▼

Manage long sessions through story-by-story isolated worktrees and handoff discipline. This Skill supports safe multi-story delivery by driving isolated implementation and controlled merges into a dedicated merge worktree.

Related Skills

Explore More Software Engineering Skills→
takuto277takuto277

git-worktree-create

Create an isolated git worktree with a dedicated branch and base metadata.

Community
Advanced
jongensutrechtjongensutrecht
1

bmad-codex

Coordinate BMAD Codex story workflows with isolated worktrees and proof-gated merges.

Community
Advanced
jongensutrechtjongensutrecht
1

start-bmad-ralph

Orchestrate story-driven development workflows with CTO Guard validation and repo governance.

Community
Advanced
lyfe2025lyfe2025
4

using-git-worktrees

Create isolated git worktrees with automatic setup and safety checks.

Community
Advanced