SpecRunnerDocs
ドキュメントPipeline
CONCEPT

Pipeline

Standard 13ステップ、収束ループ、実行プロファイルと拡張境界をコード上の構成に沿って説明します。

このページの内容

Standard — 13 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
implementer

テストと実装を作成

07
verification

build・typecheck・test・lintを検証

08
build-fixer

検証失敗を修正

09
code-review

実装差分をレビュー

10
code-fixer

コード上の指摘を修正

11
conformance

受け入れ基準と構造適合を確認

12
adr-gen

必要な場合にADRを生成

13
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です。

standard13 steps

仕様レビュー、test case、ADRを含む標準構成。

fast9 steps

spec-review、spec-fixer、test-case-gen、adr-genを除外。

design-only1 step

designのみを実行して終了。

request.md — Meta
- **pipeline**: fast

FastはconformanceでpermissionScopeを評価し、changed filesを導出できるruntimeを要求します。

拡張できる場所

対象形式影響
Rulesspecrunner/rules/<step>/*.md既存stepへ規律を追加
Custom reviewersspecrunner/reviewers/<name>.mdcode-review後にparallel fan-out
Pipeline shaperegistry.tsコード変更が必要

追加方法、activation条件、再開時の扱いはRulesとCustom reviewersで確認できます。

参照ソース 3