仕様レビュー、test materialization、bite evidence、ADRを含む標準構成。
CONCEPT
Pipeline
Standard 15ステップ、収束ループ、実行プロファイルと拡張境界をコード上の構成に沿って説明します。
このページの内容
Standard — 15 steps
reviewerやrulesはデータで追加できますが、どのstepが存在し、どの順で並ぶかはPipeline registryが決めます。Pipelineの形はコードです。
01
request-review
request.mdを検証し、不明点はescalation
02
design
branchを作成し、仕様を設計
03
spec-review
仕様をレビュー
04
spec-fixer
指摘に応じて仕様を修正
05
test-case-gen
テストケース定義を生成
06
test-materialize
テストケースを実行可能なテストへ固定
07
implementer
固定されたテストに対して実装を作成
08
bite-evidence
テストが変更前に失敗し変更後に通るか検証
09
verification
build・typecheck・test・lintを検証
10
build-fixer
検証失敗を修正
11
code-review
実装差分をレビュー
12
code-fixer
コード上の指摘を修正
13
conformance
受け入れ基準と構造適合を確認
14
adr-gen
必要な場合にADRを生成
15
pr-create
GitHub Pull Requestを作成
pr-create成功後もjobは終端ではありません。人間の確認からarchiveまでの境界はPR・merge・archiveを参照してください。
Reviewer / Fixerを収束させる
judge agentはfindingsを返し、CLIがverdictと遷移を導出します。iteration budgetを使い切ると、人間の判断が必要なescalationへ進みます。
spec-reviewspec-fixerへ戻す
verificationbuild-fixerへ戻す
code-reviewcode-fixerへ戻す
conformance必要ならimplementerへ戻す
gateのskip不能性とverdict導出の保証範囲は安全性と保証を参照してください。
実行プロファイル
request.mdのMetaに- **pipeline**: <id>を追加して選択します。省略時はstandardです。
spec-review、spec-fixer、test-case-gen、adr-genを除外。
designのみを実行して終了。
- **pipeline**: fastFastはconformanceでpermissionScopeを評価し、changed filesを導出できるruntimeを要求します。
保証floorとの関係。 fastはspec-review、test-case-gen、test-materialize、bite-evidenceを実行しないため、それらの達成証跡を必要とするminimumAssuranceには使えません。standardは必要条件ですが、対象test、request type、最終HEADの証跡まで成立して初めてfloorを満たします。詳しくは安全性と保証を参照してください。
拡張できる場所
| 対象 | 形式 | 影響 |
|---|---|---|
| Rules | specrunner/rules/<step>/*.md | 既存stepへ規律を追加 |
| Custom reviewers | specrunner/reviewers/<name>.md | code-review後にparallel fan-out |
| Pipeline shape | registry.ts | コード変更が必要 |
追加方法、activation条件、再開時の扱いはRulesとCustom reviewersで確認できます。