Workflow orchestration plugin for Claude Code. Guides complex tasks through structured phases with review checkpoints.
- Claude Code
- Superpowers plugin
claude plugins add mguilarducci/vrau/vrau:start
That's it. One command handles everything.
- Run
/vrau:start - Describe what you're working on
- Choose tracking mode:
- GitHub Issue - Track via issue comments, PRs for reviews
- None - File-based state detection only
- Choose branch setup (worktree or new branch)
- Vrau creates a workflow folder and guides you through phases
- Run
/vrau:start - Vrau detects existing workflows and shows options:
- Resume a workflow
- Start new
- Delete old workflow
┌─────────────┐ ┌──────────┐ ┌─────────────┐
│ BRAINSTORM │ ──▶ │ PLAN │ ──▶ │ EXECUTE │
│ + Review │ │ + Review │ │ + PR │
└─────────────┘ └──────────┘ └─────────────┘
┌──────────────────────────────────────────────────────────────────┐
│ STEP 1: BRAINSTORMING (sonnet) │
│ Invoke superpowers:brainstorming skill │
│ → Clarifying questions → Design exploration → Document │
└──────────────────────────────────────────────────────────────────┘
│
▼
┌──────────────────────────────────────────────────────────────────┐
│ STEP 2: SAVE & CREATE PR │
│ Save to design/brainstorm.md, run /commit-push-pr │
└──────────────────────────────────────────────────────────────────┘
│
▼
┌──────────────────────────────────────────────────────────────────┐
│ STEP 3: PR-BASED REVIEW LOOP │
│ Spawn reviewer → /review-comment │
│ → APPROVED: /merge-pr │
│ → REVISE: /read-review-update-pr, loop (max 3x) │
└──────────────────────────────────────────────────────────────────┘
│
▼
[PHASE 2: PLAN]
┌──────────────────────────────────────────────────────────────────┐
│ WRITE PLAN (opus) │
│ Invoke superpowers:writing-plans skill │
│ → Task breakdown → Dependencies → Implementation steps │
└──────────────────────────────────────────────────────────────────┘
│
▼
┌──────────────────────────────────────────────────────────────────┐
│ PR-BASED REVIEW LOOP │
│ Run /commit-push-pr, spawn reviewer → /review-comment │
│ → APPROVED: /merge-pr │
│ → REVISE: /read-review-update-pr, loop (max 3x) │
└──────────────────────────────────────────────────────────────────┘
│
▼
[PHASE 3: EXECUTE]
┌──────────────────────────────────────────────────────────────────┐
│ EXECUTION (model per task from plan) │
│ → Parse dependency graph → Dispatch parallel groups │
│ → Code review after each group │
└──────────────────────────────────────────────────────────────────┘
│
▼
┌──────────────────────────────────────────────────────────────────┐
│ FINALIZE │
│ Verification → Final PR (closes issue if tracking) │
└──────────────────────────────────────────────────────────────────┘
│
▼
[WORKFLOW COMPLETE]
Vrau provides atomic operations as slash commands:
| Command | Purpose |
|---|---|
/start-job |
Verify/create GitHub issue, link to workflow |
/track-task |
Post status update comment to linked issue |
/commit-push-pr |
Stage, commit, push, create PR atomically |
/review-comment |
Post structured review as PR comment |
/read-review-update-pr |
Read review, make changes, push |
/merge-pr |
Merge approved PR to main |
/sync-main |
Fetch and merge main into current branch |
All workflow artifacts are stored in docs/designs/:
docs/designs/2026-01-16-feat-user-auth/
├── README.md # Workflow metadata (tracking mode, issue link)
├── design/
│ └── brainstorm.md # Phase 1 output
└── plan/
└── plan.md # Phase 2 output
Vrau plans include dependency tracking for parallel execution:
Each task specifies what it depends on:
### Task 3: Feature Implementation
**Depends on:** Task 1, Task 2
**Parallel group:** B
**Model:** sonnetTasks in the same parallel group run concurrently:
| Group | Tasks | Runs After |
|---|---|---|
| A | 0, 1 | (start) |
| B | 2, 3, 4 | Group A |
| C | 5 | Group B |
Each task specifies which model to use:
- haiku: Simple setup, config
- sonnet: Standard implementation
- opus: Complex logic (requires approval)
Vrau knows where you are by checking workflow contents:
Tracking Mode: GitHub
Uses issue comments for status. PRs track review progress.
Tracking Mode: None
| Files Present | State | What Happens |
|---|---|---|
| README.md only | Not started | Begin brainstorm |
| + design/*.md | Brainstorm done | Begin planning |
| + plan/*.md | Plan done | Begin execution |
When tracking mode is None, vrau asks user to confirm detected state before proceeding.
Autonomous execution, user-driven decisions.
Vrau automates the tedious parts while keeping you in control of all key decisions. Each phase has a PR-based review checkpoint where you can adjust course.
MIT