Skip to content
This repository was archived by the owner on Apr 11, 2026. It is now read-only.

Commit 6252fe4

Browse files
z23ccclaude
andcommitted
docs: update all documentation for v0.1.43
- CHANGELOG: add v0.1.43 entry with 7 BMAD patterns + write-file + checklist - README/README_CN: bump badge to v0.1.43, fix command count (37→39), add What's New section - docs/flowctl.md: add write-file and checklist command documentation - docs/skills.md: update skill count (26→47 extensions, 54 total), add Architecture & Infrastructure category - CLAUDE.md: add zero-findings-halt rule to Quality Gates section - docs/comparison: fix command count references Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 030daa5 commit 6252fe4

8 files changed

Lines changed: 133 additions & 11 deletions

File tree

CHANGELOG.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,27 @@ All notable changes to Flow-Code are documented in this file.
44

55
Format follows [Keep a Changelog](https://keepachangelog.com/). Versions use [Semantic Versioning](https://semver.org/).
66

7+
## [0.1.43] - 2026-04-08
8+
9+
### Added
10+
- **7 BMAD-METHOD patterns** adopted from deep analysis of BMAD-METHOD v6.2.2
11+
- `flowctl write-file` — Pipeline file I/O command (bypasses Claude Code permission prompts for zero-interaction pipelines)
12+
- `flowctl checklist` — Structured Definition of Done with init/check/uncheck/verify/show subcommands (8 default items across 4 categories)
13+
- `project-context.md` support — Shared technical standards document auto-loaded by Worker Phase 2 re-anchoring (template in `templates/`)
14+
- Zero-findings-halt review rule — Reviewers must find issues; zero findings triggers NEEDS_REANALYSIS
15+
- Three-layer parallel code review — Blind Hunter (diff-only) + Edge Case Hunter (boundary analysis) + Acceptance Auditor (spec compliance)
16+
- Advanced elicitation methods in brainstorm — Pre-mortem, First Principles, Inversion, Red Team, Constraint Removal, Stakeholder Mapping
17+
- `--quick` flag for `/flow-code:go` — Fast path skipping brainstorm/plan for trivial changes
18+
- Step-file architecture — 15 step files across plan (5), work (5), brainstorm (5) for JIT loading
19+
- 3 deep comparison documents: flow-code vs compound-engineering, flow-code vs BMAD-METHOD, BMAD lessons analysis
20+
21+
### Changed
22+
- Skills now use step-file workflow (JIT loading) instead of monolithic steps.md/phases.md
23+
- Removed legacy workflow files (steps.md, phases.md, examples.md) in favor of steps/ directories
24+
- `flowctl parse-findings` now detects zero findings and returns NEEDS_REANALYSIS verdict
25+
- Worker agent Phase 2 now reads `.flow/project-context.md` if present
26+
- `flowctl init` now hints about project-context.md template
27+
728
## [0.1.42] - 2026-04-08
829

930
### Added

CLAUDE.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,7 @@ Every epic passes through three independent, non-overlapping review gates:
4545
| **2. RP Plan-Review** | RP context_builder or Codex | Plan phase | Spec-code misalignment, missing requirements |
4646
| **3. Codex Adversarial** | `flowctl codex adversarial` | Epic completion | Security, concurrency, edge cases (different model family) |
4747

48-
All three must pass (or be skipped via `flowctl config set review.backend none`). Layers are complementary — guard catches syntax, RP catches spec drift, Codex catches blind spots.
48+
All three must pass (or be skipped via `flowctl config set review.backend none`). Layers are complementary — guard catches syntax, RP catches spec drift, Codex catches blind spots. **Zero-findings-halt rule**: review cycles stop immediately when no findings remain, eliminating unnecessary re-review iterations. Conversely, zero findings from an adversarial review triggers re-analysis (review may be insufficient).
4949

5050
## Command Flags
5151

README.md

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](../../LICENSE)
88
[![Claude Code](https://img.shields.io/badge/Claude_Code-Plugin-blueviolet)](https://claude.ai/code)
99

10-
[![Version](https://img.shields.io/badge/Version-0.1.42-green)](https://github.com/z23cc/flow-code/releases)
10+
[![Version](https://img.shields.io/badge/Version-0.1.43-green)](https://github.com/z23cc/flow-code/releases)
1111

1212
[![Status](https://img.shields.io/badge/Status-Active_Development-brightgreen)](https://github.com/z23cc/flow-code/releases)
1313

@@ -29,7 +29,7 @@ A **harness** wraps around an AI coding agent to handle everything the model can
2929

3030
| Capability | Flow-Code | [compound-engineering](https://github.com/EveryInc/compound-engineering-plugin) (12.5K⭐) | [claude-mem](https://github.com/thedotmack/claude-mem) (44K⭐) | [superpowers](https://github.com/anthropics/claude-plugins-official) |
3131
|---|---|---|---|---|
32-
| Task DAG + state machine |37 commands, deps, split/skip ||||
32+
| Task DAG + state machine |39 commands, deps, split/skip ||||
3333
| Parallel Teams + file lock | ✅ Agent Teams, atomic locks ||| ✅ parallel agents (no locks) |
3434
| Three-layer quality | ✅ guard + RP + Codex adversarial ||||
3535
| Runtime DAG mutation | ✅ split/skip/dep rm mid-execution ||||
@@ -39,6 +39,17 @@ A **harness** wraps around an AI coding agent to handle everything the model can
3939
| Auto draft PR |||||
4040
| Minimal dependencies | ✅ single Rust binary + git/jq/gh | ❌ Node.js | ❌ ChromaDB | ❌ Node.js |
4141

42+
### What's New in v0.1.43
43+
44+
- **`write-file` command** — pipeline helper that writes content to files, bypassing permission prompts
45+
- **`checklist` command** — structured Definition of Done checklists for epics
46+
- **`project-context.md`** — auto-generated project context document for onboarding and agent orientation
47+
- **Step-file architecture** — modular step files replace monolithic skill definitions, enabling per-step overrides and composition
48+
- **3-layer parallel code review** — guard, RP plan-review, and Codex adversarial now run concurrently where possible
49+
- **Zero-findings-halt rule** — review cycles stop immediately when no findings remain, eliminating unnecessary re-review iterations
50+
- **Quick-dev fast path** — small, well-scoped changes skip full planning overhead and execute directly
51+
- **Advanced elicitation** — improved requirement extraction via structured probing during brainstorm and interview phases
52+
4253
---
4354

4455
## Table of Contents

README_CN.md

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](../../LICENSE)
88
[![Claude Code](https://img.shields.io/badge/Claude_Code-Plugin-blueviolet)](https://claude.ai/code)
99

10-
[![Version](https://img.shields.io/badge/Version-0.1.42-green)](../../CHANGELOG.md)
10+
[![Version](https://img.shields.io/badge/Version-0.1.43-green)](../../CHANGELOG.md)
1111

1212
[![Status](https://img.shields.io/badge/Status-Active_Development-brightgreen)](../../CHANGELOG.md)
1313

@@ -29,14 +29,25 @@
2929

3030
| 能力 | Flow-Code | [compound-engineering](https://github.com/EveryInc/compound-engineering-plugin) (12.5K⭐) | [claude-mem](https://github.com/thedotmack/claude-mem) (44K⭐) | [superpowers](https://github.com/anthropics/claude-plugins-official) |
3131
|---|---|---|---|---|
32-
| Task DAG + 状态机 |37 命令,依赖图,split/skip ||||
32+
| Task DAG + 状态机 |39 命令,依赖图,split/skip ||||
3333
| Teams 并行 + 文件锁 | ✅ Agent Teams,原子锁 ||| ✅ 并行 agents(无锁) |
3434
| 三层质量体系 | ✅ guard + RP + Codex 对抗 ||||
3535
| 运行时 DAG 变更 | ✅ 执行中 split/skip/dep rm ||||
3636
| 跨模型对抗审查 | ✅ GPT 试图破坏 Claude 的代码 ||||
3737
| 全自动(零问题) | ✅ AI 决定 branch/review/depth ||||
3838
| 零依赖 | ✅ 单 Rust 二进制 + Bash 技能 | ❌ Node.js | ❌ ChromaDB | ❌ Node.js |
3939

40+
### v0.1.43 新增功能
41+
42+
- **`write-file` 命令** — 流水线辅助工具,写入文件内容,绕过权限提示
43+
- **`checklist` 命令** — 为 epic 提供结构化的完成定义检查清单
44+
- **`project-context.md`** — 自动生成的项目上下文文档,用于入职和 agent 定向
45+
- **Step-file 架构** — 模块化步骤文件取代单体 skill 定义,支持逐步覆盖和组合
46+
- **三层并行代码审查** — guard、RP plan-review 和 Codex 对抗审查现在可以并行运行
47+
- **零发现即停止规则** — 当没有剩余发现时,审查循环立即停止,消除不必要的重复审查
48+
- **Quick-dev 快速路径** — 小型、范围明确的变更跳过完整规划开销,直接执行
49+
- **高级需求引导** — 在头脑风暴和访谈阶段通过结构化探针改进需求提取
50+
4051
---
4152

4253
## 目录

docs/comparison-flow-code-vs-compound.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -157,7 +157,7 @@ compound-engineering's multi-platform conversion system is a significant differe
157157

158158
### Analysis
159159

160-
flow-code provides richer CLI tooling (37 commands with JSON output), more autonomous operation by default, and specialized tools (debug, map, prime, auto-improve) that compound lacks. compound-engineering provides better interactive workflows, universal planning for non-software tasks, and structured ideation.
160+
flow-code provides richer CLI tooling (39 commands with JSON output), more autonomous operation by default, and specialized tools (debug, map, prime, auto-improve) that compound lacks. compound-engineering provides better interactive workflows, universal planning for non-software tasks, and structured ideation.
161161

162162
---
163163

@@ -245,7 +245,7 @@ flow-code provides richer CLI tooling (37 commands with JSON output), more auton
245245
| **Quality** | 3 layers + circuit breaker | 20+ personas + autofix routing |
246246
| **Knowledge** | Auto-capture + staleness check | Compounding + dual-track schemas |
247247
| **Platforms** | Claude + Codex sync | 10+ platform targets |
248-
| **CLI** | 37 commands with --json | No CLI (converter only) |
248+
| **CLI** | 39 commands with --json | No CLI (converter only) |
249249
| **Safety** | File locking + invariants + gaps | Convention-based |
250250
| **Learning** | Retro + memory + auto-improve | Compound + refresh |
251251
| **Rollout** | No beta framework | Beta skills + safe rollouts |

docs/flowctl.md

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1317,6 +1317,42 @@ flowctl import [--json]
13171317

13181318
Rebuilds the DB from `.flow/` Markdown files.
13191319

1320+
### write-file
1321+
1322+
Write content to a file. Pipeline helper that bypasses Claude Code permission prompts.
1323+
1324+
```bash
1325+
# Inline content
1326+
flowctl write-file --path "path/to/file.md" --content "content here" --json
1327+
1328+
# Stdin (for long content via heredoc)
1329+
cat <<'EOF' | flowctl write-file --path "path/to/file.md" --stdin --json
1330+
Long content here...
1331+
EOF
1332+
1333+
# Append mode
1334+
flowctl write-file --path "path/to/file.md" --content "new line" --append --json
1335+
```
1336+
1337+
Options:
1338+
- `--path` (required) — Target file path. Creates parent directories if needed.
1339+
- `--content` — Inline content string
1340+
- `--stdin` — Read content from stdin
1341+
- `--append` — Append instead of overwrite
1342+
1343+
### checklist
1344+
1345+
Structured Definition of Done checklists for tasks. 8 default items across 4 categories (context, implementation, testing, documentation).
1346+
1347+
Subcommands:
1348+
- `checklist init --task <id>` — Create default DoD checklist for a task
1349+
- `checklist check --task <id> --item <key>` — Mark item as checked
1350+
- `checklist uncheck --task <id> --item <key>` — Unmark item
1351+
- `checklist verify --task <id>` — Verify all items; exits 1 if any missing
1352+
- `checklist show --task <id>` — Display current checklist state
1353+
1354+
Storage: `.flow/checklists/<task-id>.json`
1355+
13201356
### completions
13211357

13221358
Generate shell completions.

docs/skills.md

Lines changed: 46 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -16,17 +16,18 @@ These skills form the primary workflow. They ship with the plugin.
1616
| `flow-code-setup` | `/flow-code:setup` | Install flowctl CLI and configure project | `skills/` |
1717
| `flow-code-map` | `/flow-code:map` | Generate codebase architecture maps | `skills/` |
1818

19-
## Extension Skills (26)
19+
## Extension Skills (47)
2020

21-
Optional capabilities that extend the core workflow.
21+
Optional capabilities that extend the core workflow. Skills live in `skills/` and/or `codex/skills/` (54 unique skills total, 7 core + 47 extension).
2222

23-
### Review & Quality (codex/skills/)
23+
### Review & Quality
2424

2525
| Skill | Command | Purpose |
2626
|-------|---------|---------|
2727
| `flow-code-plan-review` | Internal | Cross-model plan validation (RP or Codex) |
2828
| `flow-code-impl-review` | Internal | Per-task implementation review with fix loop |
2929
| `flow-code-epic-review` | Internal | Epic completion adversarial gate |
30+
| `flow-code-code-review` | Internal | Five-axis scoring with severity labels (Worker Phase 6, impl-review, PR review) |
3031

3132
### Development Extensions
3233

@@ -39,6 +40,28 @@ Optional capabilities that extend the core workflow.
3940
| `flow-code-deps` | `/flow-code:deps` | Dependency graph visualization and execution order |
4041
| `flow-code-api-design` | `/flow-code:api-design` | API design and module boundary review |
4142
| `flow-code-performance` | `/flow-code:performance` | Performance investigation, optimization, and benchmarks |
43+
| `flow-code-tdd` | `/flow-code:tdd` | Test-first methodology, Prove-It Pattern, coverage strategy |
44+
| `flow-code-incremental` | Internal | Vertical slicing, incremental commits, Implement-Test-Verify-Commit cycle |
45+
| `flow-code-simplify` | `/flow-code:simplify` | Reduce code complexity while preserving exact behavior |
46+
| `flow-code-frontend-ui` | `/flow-code:frontend-ui` | Production-quality UI: components, layouts, state, accessibility |
47+
48+
### Architecture & Infrastructure Skills
49+
50+
| Skill | Command | Purpose |
51+
|-------|---------|---------|
52+
| `flow-code-security` | Internal | OWASP Top 10, three-tier security boundaries |
53+
| `flow-code-auth` | Internal | Authentication, authorization, OAuth, JWT, RBAC, session management |
54+
| `flow-code-database` | Internal | Schema design, migrations, query optimization, ORM patterns |
55+
| `flow-code-caching` | Internal | HTTP cache, CDN, Redis, in-memory, cache invalidation strategy |
56+
| `flow-code-containerization` | Internal | Dockerfiles, docker-compose, Kubernetes, image optimization |
57+
| `flow-code-microservices` | Internal | Service boundaries, inter-service communication, saga, event-driven |
58+
| `flow-code-realtime` | Internal | WebSocket, SSE, long-polling, connection management, scaling |
59+
| `flow-code-state-management` | Internal | Frontend/full-stack state architecture, tool selection, patterns |
60+
| `flow-code-error-handling` | Internal | Error classification, retry logic, circuit breakers, graceful degradation |
61+
| `flow-code-i18n` | Internal | Multi-language support, locale formatting, RTL layouts |
62+
| `flow-code-monitoring` | Internal | Dashboards, SLOs/SLIs, alerting rules, on-call runbooks |
63+
| `flow-code-observability` | Internal | Logging, tracing, metrics, health endpoints |
64+
| `flow-code-documentation` | Internal | ADRs, API docs, READMEs, changelogs, doc-as-code workflow |
4265

4366
### Workflow Extensions
4467

@@ -51,6 +74,7 @@ Optional capabilities that extend the core workflow.
5174
| `flow-code-autoplan` | `/flow-code:autoplan` | Multi-perspective auto-review pipeline (CEO, eng, design, DX) |
5275
| `flow-code-qa` | `/flow-code:qa` | Visual QA testing with browser automation |
5376
| `flow-code-design-review` | `/flow-code:design-review` | Visual design audit with browser automation |
77+
| `flow-code-guide` | Internal | Skill discovery flowchart — helps select the right skill |
5478

5579
### Tooling Extensions
5680

@@ -99,6 +123,7 @@ Simple utilities and wrappers that perform a single focused action.
99123
| `flow-code-export-context` | Export context for external model review |
100124
| `flow-code-deps` | Dependency graph visualization |
101125
| `flow-code-loop-status` | Monitor running loops |
126+
| `flow-code-guide` | Skill discovery flowchart |
102127
| `browser` | Browser automation via agent-browser CLI |
103128
| `flow-code-rp-explorer` | RepoPrompt-powered codebase exploration |
104129

@@ -114,6 +139,9 @@ Skills that gather information, analyze codebases, or provide monitoring and gui
114139
| `flow-code-performance` | Performance investigation and benchmarks |
115140
| `flow-code-prompt-eng` | Prompt engineering guidance for review agents |
116141
| `flow-code-debug` | Systematic debugging with root cause investigation |
142+
| `flow-code-monitoring` | Dashboards, SLOs/SLIs, alerting rules |
143+
| `flow-code-observability` | Logging, tracing, metrics, health endpoints |
144+
| `flow-code-documentation` | ADRs, API docs, changelogs, doc-as-code |
117145

118146
### Tier 3 — Interactive Decision-Making
119147

@@ -138,9 +166,24 @@ Skills that involve planning, design, or interactive multi-step workflows.
138166
| `flow-code-plan-review` | Cross-model plan validation |
139167
| `flow-code-impl-review` | Per-task implementation review |
140168
| `flow-code-epic-review` | Epic completion adversarial gate |
169+
| `flow-code-code-review` | Five-axis scoring with severity labels |
141170
| `flow-code-qa` | Visual QA testing with browser |
142171
| `flow-code-design-review` | Visual design audit with browser |
143172
| `flow-code-autoplan` | Multi-perspective auto-review pipeline |
173+
| `flow-code-tdd` | Test-first methodology, Prove-It Pattern |
174+
| `flow-code-incremental` | Vertical slicing, incremental commits |
175+
| `flow-code-simplify` | Reduce complexity while preserving behavior |
176+
| `flow-code-frontend-ui` | Production-quality UI components and layouts |
177+
| `flow-code-security` | OWASP Top 10, security boundaries |
178+
| `flow-code-auth` | Authentication, authorization, OAuth, JWT, RBAC |
179+
| `flow-code-database` | Schema design, migrations, query optimization |
180+
| `flow-code-caching` | HTTP cache, CDN, Redis, cache invalidation |
181+
| `flow-code-containerization` | Docker, Kubernetes, image optimization |
182+
| `flow-code-microservices` | Service boundaries, saga, event-driven patterns |
183+
| `flow-code-realtime` | WebSocket, SSE, connection management |
184+
| `flow-code-state-management` | Frontend/full-stack state architecture |
185+
| `flow-code-error-handling` | Error classification, retry, circuit breakers |
186+
| `flow-code-i18n` | Multi-language support, locale formatting, RTL |
144187

145188
### Tier 4 — Final Decisions & Execution
146189

flowctl/Cargo.lock

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)