claudecodex

flow

Engineering workflow: plan, build, review, and ship a change with two human gates

0 on GitHubby Ralph Shaov0.2.7MITupdated 8 days agoProductivity
/

Plugin flow from marketplace ai-plugins in ralphshao/ai-plugins. Commands read from the repo's manifest — 7 days ago.

This plugin runs code on your machine — its hooks fire automatically on events like tool use. The exact commands are listed below; read them before installing.

What it installs

Skills (14)

  • brb

    Keeps this session's prompt cache warm during a break, so the first turn back reads the cache instead of rewriting the whole context. Claude Code only.

  • change-body

    The shape of a code review description (pull request, Swarm review, or changelist description) - a one-sentence why, a minimal summary visual, before/after evidence, and a merge-danger call. Use when writing or updating one.

  • deep-review

    Multi-pass review of uncommitted work, a branch, or committed code (git SHA or range, PR, Perforce changelist, Swarm review). Runs parallel flow:code-reviewer subagents, one per lens (correctness/spec, standards/quality, history, security when the diff touches a trust boundary, and silent failures w

  • flow

    Start or resume an engineering task. Sizes the work (trivial, normal, large) and walks it through start, plan, build, and ship with two human gates.

  • host-github

    How flow's review-host operations (fetch-issue, fetch-review, open-draft, ready-for-review) run on GitHub, with gh or the GitHub MCP tools. Load when a flow phase or deep-review names one of these operations and the repo's origin is on github.com.

  • host-swarm

    How flow's review-host operations (fetch-review, open-draft, ready-for-review) run on Helix Swarm for a Perforce workspace. Swarm has no issues, so there is no fetch-issue. Load when a flow phase or deep-review names one of these operations and the p4 server has a Swarm URL.

  • interview

    Interview the user about a plan, design, or decision in rounds of numbered questions with recommended answers, until no decision is left open. Use when a plan has open decisions, or the user says "interview me", "grill me", or asks to stress-test an idea.

  • plan

    Second flow phase. Explores the code, interviews the user on open decisions, writes .flow/<slug>/plan.md, and stops at GATE 1 for approval.

  • retro

    Retrospective on a coding session. Suggests fixes to the agent's environment (checks, standards, steering files, tooling) that would have prevented this session's mistakes, most severe first.

  • ship

    Last flow phase. Verifies the work, runs deep-review, fixes confirmed findings, strips .flow/, and readies the review for GATE 2.

  • start

    First flow phase. Turns a prompt or issue into an isolated workspace (branch, worktree, or changelist) and a checkpointed .flow/<slug>/brief.md.

  • tdd

    Test-driven development in red-green slices at agreed seams. Use when building a feature or fixing a bug test-first, or when the user mentions TDD or red-green-refactor.

  • vcs-git

    How flow's VCS operations (find-state, isolate, checkpoint, diff-scope, publish, drop-state, land, resolve-target) run in a git repo, on a regular branch or in a worktree. Load when a flow phase or deep-review names one of these operations in a git work tree.

  • vcs-perforce

    How flow's VCS operations (find-state, isolate, checkpoint, diff-scope, publish, drop-state, land, resolve-target) run in a Perforce (Helix Core) workspace, with pending changelists or a task/dev stream. Load when a flow phase or deep-review names one of these operations in a p4 workspace.

Subagents (4)

  • code-reviewer

    Read-only code reviewer. Scans files or a diff for correctness bugs, silent failures, project-standard violations, untested changes, and improvements to readability, performance, and best practices, showing current code and a fix for each issue. Use when asked to review, audit, or suggest improvemen

  • review-validator

    Read-only skeptic that checks code-review findings someone else reported. Tries to refute each one and returns a verdict line per finding (CONFIRMED, REFUTED, or UNSURE). Doesn't look for new issues. Use to validate review findings before reporting them.

  • strong-reviewer

    The code-reviewer on a stronger model, for deep-review's correctness and security lenses. Same instructions and limits as code-reviewer. Use only when deep-review asks for it.

  • tester

    Test coverage reviewer and writer. Scans files or a diff, maps what existing unit and integration tests cover, finds untested behavior, and writes or updates tests to fill the gaps, then runs them. Use when asked to find missing tests, check test coverage, or add/update tests for code.

Hooks (7)

  • PreToolUse

    "$(command -v python3 || command -v python)" "${CLAUDE_PLUGIN_ROOT}/hooks/guard.py"

  • PreToolUse

    "$(command -v python3 || command -v python)" "${CLAUDE_PLUGIN_ROOT}/hooks/codex_agents.py"

  • PostToolUse

    "$(command -v python3 || command -v python)" "${CLAUDE_PLUGIN_ROOT}/hooks/format.py"

  • Stop

    "$(command -v python3 || command -v python)" "${CLAUDE_PLUGIN_ROOT}/hooks/stop_gate.py"

  • Stop

    "$(command -v python3 || command -v python)" "${CLAUDE_PLUGIN_ROOT}/hooks/brb.py" stop

  • UserPromptSubmit

    "$(command -v python3 || command -v python)" "${CLAUDE_PLUGIN_ROOT}/hooks/brb.py" prompt

  • UserPromptExpansion

    "$(command -v python3 || command -v python)" "${CLAUDE_PLUGIN_ROOT}/hooks/brb.py" expand

View source on GitHub ralphshao.com

More from ralphshao/ai-plugins

All 9 plugins →

caveman

claudecodex

Ultra-compressed communication mode. Shortens prose while preserving technical terms, code, commands, and exact errors.

22 skills · 1 command · 3 agents · hooks

0

context-mode

claudecodex

MCP server that saves context window with session continuity. Sandboxed code execution, FTS5 knowledge base with BM25 ranking, and automatic state restore across compactions.

9 skills · 1 MCP server · hooks

0

ponytail

claudecodex

Lazy senior dev mode. Forces the simplest, shortest solution that actually works: YAGNI, stdlib first, no unrequested abstractions.

6 skills

0

ai-plugins

claudecodex

Maintenance skills for the ai-plugins marketplace itself

3 skills

0

i-have-adhd

claudecodex

Shape Claude Code output for an ADHD reader: lead with the next action, number steps, suppress tangents, restate state, make wins visible.

1 skill · hooks

0

Keeps claude.ai memory and profile instructions accurate, deduplicated, and in the right tier

2 skills

0

Similar plugins

caveman

claude

Talk like caveman. Cut filler. Keep technical details explicit.

22 skills · 1 command · 3 agents · hooks

JuliusBrussee/caveman 119,462

claude-mem

claudecodex

Persistent memory for Claude Code: the next session starts where the last one left off.

29 skills · 1 MCP server · hooks

thedotmack/claude-mem 116,618

Taste Skill

claudecodex

tasteskill 2.5.1: professional company websites at the figma.com and x.ai level, with one section per screen, real photographs, real product UI, effects kept for tech and gaming pages, and a real-browser checker and finish gate.

1 skill

Leonxlnx/taste-skill 114,391

career-ops

claudecodex

Open-source AI job search that runs locally in your AI coding CLI: scan job portals, evaluate listings into a structured A-H report with a 1-5 score, tailor your CV, track applications

5 skills · hooks

career-ops-hq/career-ops 82,253

mem0

claudecodex

Cross-session memory and token savings for coding agents.

6 skills · 1 agent · 1 MCP server · hooks

mem0ai/mem0 68,893

pake

claudecodex

Package any website or local web build into a lightweight desktop app with Pake CLI.

1 skill

tw93/Pake 63,463

Maintain flow?

This page updates itself from your repo. Add the badge to your README, or get it Featured to pin it above the organic results with a followed link to your site.

claude & codex plugins9 plugins