feature-flow

feature-flow

A Claude Code plugin that enforces a full feature development lifecycle — from idea to merged PR — so you don't discover schema mismatches, deprecated APIs, or broken assumptions halfway through coding. You say "start: add user notifications" and it auto-detects your tech stack, queries live documentation for current patterns, walks you through brainstorming and design, then verifies that design against your actual codebase (columns, types, routes, constraints) before a single line of implementation is written. After implementation (done via TDD in an isolated git worktree), it runs a multi-agent code review pipeline with up to 7 specialized reviewers, auto-fixes findings, generates a CHANGELOG entry, and mechanically verifies every acceptance criterion before opening a PR.

The upfront design adds ~20-30 minutes but typically saves 2-4 hours of mid-implementation debugging per feature. It works with any tech stack — Next.js, Supabase, Django, Rails, Flutter, whatever — and gets smarter over time by writing discovered gotchas (like "PostgREST silently caps queries at 1000 rows") back into your project config so every future feature is checked against past lessons.

What's New in 1.36.0 (2026-04-17)

Five features bundled into this release — all addressing gaps in design review and mid-lifecycle judgment that the existing gate chain missed. See CHANGELOG.md for the detailed entries.

PR	Issue	What it adds
#243	#238	Scope-critique pass — new Step 4.5 in design-verification asks five strategic-shape questions (scope, dependencies, simpler alternatives, observability, config surface) before a design reaches create-issue. Catches oversized scope, phantom dependencies, and unobservable capability bets.
#242	#236	Advisor tool integration — four soft advisor-call hints at judgment-heavy moments, plus a one-line SessionStart onboarding nudge for Sonnet users missing the beta header. Opt-in; see docs/advisor.md.
#241	#239	Senior developer panel (Phase 1c) — Major-feature code review gains a judgment-review phase with three personas (Staff Engineer, SRE, Product Engineer). Surfaces wrong abstractions, operability risk, and scope creep. Findings are report-only — you decide whether to address, defer, or reject.
#240	#235	Codex consultation (Phase 1+2, opt-in) — new consult-codex skill for second-opinion AI reviews via the existing codex MCP server. Ships review-design proactive mode wired into design-document; later modes (review-plan, review-code, stuck) deferred. Disabled by default; enable via codex.enabled: true.
#237	#234	Quick-path triage — start: now routes trivial changes (prose edits, non-log string literals, comments) to a bare implement-and-commit flow, skipping brainstorm / design / verify / plan / handoff. Gated by five code-aware confirmation gates (clean tree, concrete target, file/line budgets, exported-declaration overlap, lexical-region rule).

Requirements

• Claude Code CLI
• GitHub CLI (gh on PATH, authenticated via gh auth login) — used for issue creation, PR checks, review bot handling, and issue commenting/closing
• superpowers plugin (required — handles brainstorming, implementation planning, TDD, worktrees, and PR workflow)
• Context7 MCP plugin (required — provides live documentation lookups for any tech stack during design and implementation)

Recommended (for full code review coverage):

• pr-review-toolkit plugin (adds: code-simplifier, silent-failure-hunter, test-analyzer, type-design-analyzer)
• feature-dev plugin (adds: feature-dev:code-reviewer)
• backend-api-security plugin (adds: backend-security-coder)

Installation

From the marketplace

# Install required plugins first
claude plugins add superpowers
claude plugins add context7

# Install feature-flow
claude plugins add feature-flow