WORKFLOW.md — 変更ライフサイクルとゲートシステム
Forgeにおける変更開発サイクルと機械的ゲートの完全な定義。
1. コア原則
- 成果物DAGはデータである:
.forge/schema/<type>.yamlに成果物間の依存関係を定義。完了判定はディスク上のファイル存在に基づき、状態の不整合を防ぎます。 - ゲートは終了コードである:
forge gate <point>は決定論的テストを実行し、失敗時は0以外の終了コードで物理的に処理を中断します。
2. 3トラック・スケールルーター
- Track A (Probe): フィージビリティ検証、使い捨てのスパイク調査。
- Track B (Bounded): 既存フロー内の局所的な修正（ロジック変更時は仕様作成、TDDタスク）。
- Track C (Structural): 新規モジュール、API変更、スキーマ変更、不変条件の変更（完全なDAGとADR）。
- 一方向ラチェット: 複雑度の上昇に伴うトラック昇格（B ➔ C）のみを許可し、降格は禁止。
3. バグ修正ワークフロー (bugfix.yaml)
バグ修正では再現確認ファイル reproduce.md が最優先必須成果物として定義されます。欠陥を再現するテストの作成が証明されるまで、修正コードの実装はブロックされます。