BWGX

Build · Wave · Gate · eXecute — AI-Orchestrated Development for Claude Code.

Sets up BWGX agents, cycles, and quality gates in any project — new or existing — in seconds.

Usage

# First-time setup
npx @jeanberwanger/bwgx

# Update agents and rules to the latest version
npx @jeanberwanger/bwgx --update

Run inside any project directory. That's it.

What it does

1. Detects your project — finds PRD.md, infers tech stack from package.json
2. Asks up to 2 questions if needed (describe the project or point to a PRD file)
3. Installs into .claude/:
   • CLAUDE.md — agent configuration for Claude Code
   • rules/ — authority, handoff, workflow, and story lifecycle rules
   • commands/BWGX/ — slash commands for all agents
4. Preserves any existing CLAUDE.md — appends BWGX config without overwriting

After installation

Open the project in Claude Code and run:

/BWGX:start

This starts guided execution from your PRD through build cycles.

Agents

| Command | Agent | Role | |---------|-------|------| | @build | Builder | Writes code, commits | | @check | Checker | Tests, quality verdicts | | @think | Thinker | Architecture, planning | | @own | Owner | Stories, backlog | | @ship | Shipper | git push, PRs, releases | | @data | Data Engineer | Schema, migrations, RLS |

Each agent has exclusive authority over its domain. Use *help after activation to see available commands.

The 6 Cycles

| Cycle | When to use | |-------|------------| | feature.cycle | Building a new feature | | fix.cycle | Quick bug fix | | spec.cycle | Complex feature that needs planning first | | review.cycle | Iterative QA loop (auto, max 5×) | | discover.cycle | Joining an existing codebase | | ship.cycle | Deploying: push + PR + release |

Requirements

• Node.js 18+
• Claude Code

License

MIT