feat: pipeline hygiene — epic-review in Close, skill dir docs, audit cleanup (v0.1.51)

- Added Step 4.5 (epic-review spec compliance) to Close phase
- Documented skills/ vs codex/skills/ directory responsibilities in CLAUDE.md
- Added shared rp-review-protocol references to all 3 review skills
- Replaced stale audit warnings with verified safety invariants
- Archived 13 stale/test epics from .flow/ state

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: z23cc

.claude-plugin/flowctl-version

@@ -1 +1 @@
-v0.1.50
+v0.1.51

.claude-plugin/marketplace.json

@@ -6,13 +6,13 @@
   },
   "metadata": {
     "description": "Structured plan-first development plugin for Claude Code with .flow/ task tracking, Agent Teams, and Ralph autonomous mode",
-    "version": "0.1.50"
+    "version": "0.1.51"
   },
   "plugins": [
     {
       "name": "flow-code",
       "description": "Zero-dependency planning + execution with .flow/ task tracking. Three-layer quality (guard + RP plan-review + Codex adversarial). Full-auto, zero questions. Teams auto-parallel, DAG mutation, Codex-driven decisions, auto draft-PR, session summary. 5 prompt templates plus dedicated subagents, slash commands, and skills.",
-      "version": "0.1.50",
+      "version": "0.1.51",
       "source": "./",
       "category": "workflow",
       "tags": [
@@ -26,5 +26,5 @@
       "strict": true
     }
   ],
-  "version": "0.1.50"
+  "version": "0.1.51"
 }

.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "flow-code",
-  "version": "0.1.50",
+  "version": "0.1.51",
   "description": "Zero-dependency planning + execution with .flow/ task tracking and Ralph autonomous mode (multi-model review gates). Worker subagent per task with git worktree isolation for parallel execution. Three-layer quality system (guard + RP plan-review + Codex adversarial). Full-auto by default — AI decides from context, zero questions. Teams-default with file locking, DAG mutation, Codex-driven conflict resolution, auto draft-PR. Auto-detected stack profiles with one-command guard (test/lint/typecheck). Enhanced agent definitions with permissionMode/maxTurns/effort. Lifecycle hooks with state preservation (PreCompact injects .flow state into compaction, TaskCompleted auto-unlocks files, SubagentStart context injection). Memory v2 with atomic entries, dedup, and progressive disclosure. TDD enforcement mode. Multi-epic queue with dependency visualization. Includes dedicated subagents, slash commands, and skills for planning, execution, review, and autonomous operation.",
   "author": {
     "name": "z23cc",

.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "flow-code",
-  "version": "0.1.50",
+  "version": "0.1.51",
   "description": "Zero-dependency planning + execution with .flow/ task tracking and Ralph autonomous mode (multi-model review gates). Worker subagent per task with git worktree isolation for parallel execution. Three-layer quality system (guard + RP plan-review + Codex adversarial). Full-auto by default. Teams-default with file locking, DAG mutation, Codex-driven conflict resolution, auto draft-PR.",
   "author": {
     "name": "z23cc",

CHANGELOG.md

@@ -4,6 +4,19 @@ All notable changes to Flow-Code are documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/). Versions use [Semantic Versioning](https://semver.org/).
 
+## [0.1.51] - 2026-04-10
+
+### Added
+- **Epic review step** (Step 4.5) in Close phase — verifies spec compliance before shipping
+- **Shared review protocol references** in plan-review, impl-review, and epic-review skills
+
+### Changed
+- `CLAUDE.md` now documents `skills/` vs `codex/skills/` directory responsibilities and priority rules
+- Work phase audit warnings replaced with clean safety invariants (issues verified fixed since v0.1.48)
+
+### Removed
+- Archived 13 stale/test epics from .flow/ state (5 completed, 1 abandoned, 7 test)
+
 ## [0.1.50] - 2026-04-10
 
 ### Added

CLAUDE.md

@@ -19,7 +19,11 @@ hooks/hooks.json         → Ralph workflow guards (active when FLOW_RALPH=1)
 docs/                    → Architecture docs, CI examples
 ```
 
-**Skill directories**: Both `skills/` and `codex/skills/` are scanned. Core workflow skills (plan, work, reviews) live in `codex/skills/` for Codex sync compatibility. Both directories are authoritative.
+**Skill directories**: Two directories exist with different responsibilities:
+- `skills/` — **Primary for Claude Code**. Contains all skills including the pipeline engine (`flow-code-run`), domain skills, and standalone tools. This is the authoritative source when both directories have the same skill name.
+- `codex/skills/` — **Codex CLI sync subset**. Contains core workflow skills (plan, work, reviews) and step files that Codex CLI needs. When a skill exists in both directories, `skills/` has the more complete version (user-invocable flags, extended sections, Claude Code-specific paths). `codex/` has the Codex-compatible version (hardcoded `$HOME/.codex` paths, no user-invocable flag).
+
+21 skills currently exist in both directories. For Claude Code, `skills/` always wins on conflict.
 
 **Skills**: Use `skills/flow-code-guide/SKILL.md` as the discovery index and browse `skills/*/SKILL.md` + `codex/skills/*/SKILL.md` for full coverage. Core workflow: `flow-code-run` (unified phase loop via `flowctl phase next/done`).
 

bin/flowctl

@@ -7,6 +7,8 @@ user-invocable: false
 
 # Epic Completion Review Mode
 
+> **Shared protocol**: Backend detection and review loop are defined in `skills/_shared/rp-review-protocol.md`. This skill sets review-specific variables and follows that protocol.
+
 **Read [workflow.md](workflow.md) for detailed phases and anti-patterns.**
 
 Verify that the combined implementation of all epic tasks satisfies the spec requirements. This is NOT a code quality review (that's impl-review's job) — this confirms spec compliance only.

codex/skills/flow-code-epic-review/SKILL.md

@@ -7,6 +7,8 @@ user-invocable: false
 
 # Implementation Review Mode
 
+> **Shared protocol**: Backend detection and review loop are defined in `skills/_shared/rp-review-protocol.md`. This skill sets review-specific variables and follows that protocol.
+
 **Read [workflow.md](workflow.md) for detailed phases and anti-patterns.**
 
 Conduct a John Carmack-level review of implementation changes on the current branch.

codex/skills/flow-code-impl-review/SKILL.md

@@ -7,6 +7,8 @@ user-invocable: false
 
 # Plan Review Mode
 
+> **Shared protocol**: Backend detection and review loop are defined in `skills/_shared/rp-review-protocol.md`. This skill sets review-specific variables and follows that protocol.
+
 **Read [workflow.md](workflow.md) for detailed phases and anti-patterns.**
 
 Conduct a John Carmack-level review of epic plans.