orch-build-mvp

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

orch-build-mvp

Actor · action · target: orch · build · mvp. Thin wrapper over the shared engine in

orch-pipeline

角色·操作·目标：orch · build · mvp。是

orch-pipeline

中共享引擎的轻量封装。

When to Use

使用场景

The user has a design / spec document (SDD, PRD, system_design) and wants a working vertical slice bootstrapped from it.
Takes a doc path as its argument, e.g.
```
civicpulse/docs/SDD-v0.6.md
```
.

用户拥有设计/规格文档（SDD、PRD、system_design），希望基于文档搭建可运行的精简垂直切片框架。
需传入文档路径作为参数，例如
```
civicpulse/docs/SDD-v0.6.md
```
。

Operation settings

操作设置

Default size floor: large — this is the full pipeline including Scaffold.
Phase mask: 0 (read the spec) → 1 → 2 (heavy) → 3 (scaffold) → 4 → 5 → 6.
First move (phase 0 → 2): read the doc; extract scope, locked decisions, and the feature list; order it into thin vertical slices (one end-to-end path first, not all-models-then-all-views). Phase 3 stands up that first slice.

默认规模下限： large —— 这是包含Scaffold的完整流水线。
阶段掩码： 0（读取规格文档）→ 1 → 2（重量级）→ 3（搭建框架）→ 4 → 5 → 6。
第一步（阶段0→2）： 读取文档；提取范围、已锁定决策和功能列表；将其排序为精简垂直切片（优先实现一条端到端路径，而非先完成所有模型再完成所有视图）。阶段3负责搭建首个切片的框架。

How It Works

工作原理

Run the
```
orch-pipeline
```
engine with the settings above.
Reuse the existing GAN harness instead of hand-rolling an iterate loop:
- Translate the SDD into
```
gan-harness/spec.md
```
  +
```
gan-harness/eval-rubric.md
```
  (this stands in for what
```
gan-planner
```
  would generate — you already have the spec).
- Drive the build with
```
/gan-build "<one-line brief>" --skip-planner
```
  (defaults:
```
--max-iterations 15
```
  ,
```
--pass-threshold 7.0
```
  ,
```
--eval-mode playwright
```
  ; use
```
--eval-mode code-only
```
  for non-UI slices).
- That command runs the
```
gan-generator
```
  →
```
gan-evaluator
```
  loop and writes
```
gan-harness/feedback/feedback-NNN.md
```
  until the score passes or plateaus.
Stop at Gate 1 (slice plan) and Gate 2 (pre-commit). Commit the scaffold and each slice as separate
```
feat:
```
commits.
Add
```
security-reviewer
```
for any slice touching a security trigger.

使用上述设置运行
```
orch-pipeline
```
引擎。
复用现有GAN harness，而非手动编写迭代循环：
- 将SDD转换为
```
gan-harness/spec.md
```
  +
```
gan-harness/eval-rubric.md
```
  （替代
```
gan-planner
```
  生成的内容——你已经拥有规格文档）。
- 通过
```
/gan-build "<one-line brief>" --skip-planner
```
  驱动构建（默认参数：
```
--max-iterations 15
```
  ，
```
--pass-threshold 7.0
```
  ，
```
--eval-mode playwright
```
  ；非UI切片使用
```
--eval-mode code-only
```
  ）。
- 该命令会运行
```
gan-generator
```
  →
```
gan-evaluator
```
  循环，并生成
```
gan-harness/feedback/feedback-NNN.md
```
  ，直到评分达标或进入平台期。
在**Gate 1（切片规划）和Gate 2（提交前）**处暂停。将框架和每个切片作为独立的
```
feat:
```
提交。
对于涉及安全触发点的切片，添加
```
security-reviewer
```
。

Example

示例

orch-build-mvp: civicpulse/docs/SDD-v0.6.md
→ read SDD → slice list (vertical) → scaffold slice 1  [GATE 1: approve]
→ /gan-build --skip-planner (generator → evaluator loop) scores vs spec → review
→ commit feat:  [GATE 2: confirm] → next slice

orch-build-mvp: civicpulse/docs/SDD-v0.6.md
→ 读取SDD → 切片列表（垂直）→ 搭建切片1框架  [GATE 1: 批准]
→ /gan-build --skip-planner（生成器→评估器循环）对比规格文档评分 → 评审
→ 提交 feat:  [GATE 2: 确认] → 下一切片