claude-code-multimodel-workflow

claude-code-multimodel-workflow

A redistributable Claude Code workflow package. Routes diffs through Claude, Codex, and CodeRabbit with pre-built dispatch rules, project-aware reviewers, codified discipline patches, and the slash commands and agents that hold it all together.

Status: v0.2.0. Repo renamed from jm-workflow for OSS clarity. See SPEC.md for the full specification and roadmap.

The workflow at a glance

flowchart TD
    Intake([Task input<br/>ticket / question / dispatch]):::start
    GateInvestigate{{HOOK<br/>investigate-before-acting}}:::hook
    Brainstorm[/superpowers:brainstorming/]:::skill
    Research[research-agent<br/>bg]:::agent
    Devils[devils-advocate<br/>bg]:::agent
    WritingPlans[/superpowers:writing-plans/]:::skill
    GatePlan{{HOOK<br/>brainstorm-nudge · plan-gate}}:::hook
    TDD[/superpowers:test-driven-development/]:::skill
    SDD[/executing-plans ·<br/>subagent-driven-development/]:::skill
    Implementers[implementer agents<br/>general-purpose · Explore · cavecrew · codex-rescue]:::agent
    GateWorktree{{HOOK<br/>parallel-cc-worktree-gate}}:::hook
    Verify[/superpowers:verification-before-completion/]:::skill
    CodeReview[/lens-review<br/>auto · lensed/]:::autocmd
    UiQA[/visual-qa · /accessibility-qa · /tone-qa<br/>auto if UI changed/]:::autocmd
    GateCodex{{HOOK<br/>codex-stop-gate}}:::hook
    Codex[Codex adversarial-review<br/>cross-provider, GPT-5.x]:::agent
    Commit[/commit: Conventional Commits/]:::autocmd
    GateCommit{{HOOK<br/>pre-commit-gate · scope-check}}:::hook
    PR[/jm-pr: drive to green/]:::cmd
    CR[CodeRabbit<br/>external PR review]:::ext
    Decision{what next?}:::start
    Precompact[/jm-precompact<br/>distill before /compact/]:::cmd
    Wrap[/jm-wrap<br/>quick wrap, ticket deferreds/]:::cmd
    Retro[/jm-retro<br/>auto-invoked/]:::autocmd
    Memory([Memory write<br/>~/.me/memory/ + CLAUDE.md]):::terminus
    Compact[/compact<br/>built-in/]:::cmd
    EndNode([Session ends]):::terminus

    Intake --> GateInvestigate --> Brainstorm
    Brainstorm <-.bg.-> Research
    Brainstorm <-.bg.-> Devils
    Brainstorm --> WritingPlans --> GatePlan --> TDD --> SDD
    SDD <-.bg.-> Implementers
    SDD --> GateWorktree --> Verify --> CodeReview
    Verify -.if UI.-> UiQA --> GateCodex
    CodeReview --> GateCodex --> Codex --> Commit
    GateCodex -.bypass: written reason.-> Commit
    Commit --> GateCommit --> PR
    PR --> CR
    CR -.iterate until green.-> PR
    PR --> Decision
    Decision -- compact --> Precompact --> Retro
    Decision -- done --> Wrap --> Retro
    Retro --> Memory
    Memory --> Compact
    Memory --> EndNode
    Compact -.fresh capacity.-> Intake

    classDef start fill:#1f6feb22,stroke:#1f6feb
    classDef terminus fill:transparent,stroke:#6e7681,stroke-dasharray:4 3
    classDef skill fill:#a371f722,stroke:#a371f7
    classDef cmd fill:#388bfd22,stroke:#388bfd
    classDef autocmd fill:#39c5d422,stroke:#39c5d4
    classDef agent fill:#23863622,stroke:#238636
    classDef ext fill:#bf870022,stroke:#bf8700
    classDef hook fill:#da363322,stroke:#da3633

Legend

Shape	Color	What it represents
rounded	blue #1f6feb	Intake / terminal node
rounded, dashed	gray #6e7681	Terminal / outcome node
parallelogram	purple #a371f7	superpowers:* skill, Claude invokes
parallelogram	blue #388bfd	/command, user types it
parallelogram	cyan #39c5d4	/command, Claude auto-invokes
rectangle	green #238636	Subagent dispatch (often background)
rectangle	gold #bf8700	External / hosted service
hexagon	red #da3633	Hook gate; must clear, retry on reject

Side branches in dashed lines are sidecars (research, devils-advocate, implementer agents, UI QA) that rejoin the spine.

For the richer original (gutters, retry arrows, full layout), open docs/workflow.html. Same content with explicit stage gutters and bypass paths annotated.

Requirements

The plugin itself only needs Claude Code. The opt-in tiers + a few hooks assume additional tooling. Install what you want to use: