mpower

AI-orchestrated development workflow framework. Separates deterministic bookkeeping (CLI state machine) from creative AI work (skill files + agent personas), enabling structured, gate-controlled software development across AI coding tools.

mpower manages phases, gates, agent personas, and document scaffolding — the AI tool does the creative work.

Installation

Requires Node.js 18+.

cd /path/to/mpower
npm install
npm run build
npm link

This makes the mpower command available globally on your machine. To use it in any project:

cd /path/to/your-project
mpower init --tool claude-code

Get Started

1. Initialize your project

npx mpower init --tool claude-code

This scaffolds your project with:

• .mpower/agents/ — 9 agent personas (brainstorm facilitator, software architect, story executor, etc.)
• .claude/commands/ — 8 workflow skill files as slash commands
• .mpower/config.json — phase-to-agent rule table
• WORKFLOW_STATUS.md — phase tracking
• docs/, reports/, tests/ — directory structure

2. Start brainstorming

Run /brainstorming in Claude Code. The AI adopts the Brainstorm Facilitator persona, asks clarifying questions, generates 3+ approaches, and writes a timestamped decision document.

3. Progress through phases

Each slash command advances the workflow:

| Command | Phase | Output | |---------|-------|--------| | /brainstorming | Ideation | docs/brainstorming/{timestamp}_{summary}.md | | /write-prd | Requirements | docs/prd.md | | /create-backlog | Story decomposition | docs/agile/backlogs/ | | /architect-design | Technical architecture | docs/architect.md | | /ui-ux-design | UX/UI design | docs/design/ | | /sprint-planning | Sprint scoping | docs/agile/sprints/sprint-{id}/index.md | | /sprint-execution | TDD implementation | Code + tests + story reports | | /sprint-review | Retrospective | reports/sprint-{N}.md |

Gates enforce quality between phases — no [TODO], [TBD], or [BLOCKER] placeholders allowed. After sprint review, the workflow cycles back to sprint planning for the next iteration.

CLI Commands

mpower status              # Current phase and story statuses
mpower phase next          # Advance phase (requires gate check)
mpower gate-check          # Run gate validation
mpower resolve <phase>     # Show lead + support agents for a phase
mpower epic create <name>  # Create an epic
mpower story create <epic-id> <name>  # Create a user story
mpower sprint create       # Start next sprint
mpower sprint add <story>  # Add story to current sprint
mpower report story <id>   # Generate story report
mpower report sprint       # Generate sprint review report

License

MIT