bmad-codex-general

Name: bmad-codex-general
Availability: InStock
Author: jongensutrecht

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

Ready to run

npx skills add https://github.com/jongensutrecht/demo-ai-stack --skill bmad-codex-general

💬 Prompt for ChatGPT / Claude Chat▼

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.