ワークフロー
Slipway は、ガバナンス対象の作業をインテイク、計画、実装、レビュー、クローズアウトの順に進めます。現在のライフサイクル状態は artifacts/changes/<slug>/change.yaml に格納されています。
ワークフローの全体像については ガバナンス対応ワークフロー を参照してください。このページではその考え方を説明します。
ライフサイクル
Section titled “ライフサイクル”| ステージ | 目的 |
|---|---|
S0_INTAKE |
意図、スコープ、未解決の論点、初期エビデンスを取り込む。 |
S1_PLAN |
リサーチ、要件、意思決定、タスク、plan-audit エビデンスを作成する。 |
S2_IMPLEMENT |
依存関係順のタスクウェーブを実行し、タスクエビデンスを記録する。 |
S3_REVIEW |
選定したレビュアーを実行し、指摘を修正し、アシュアランスを記述して done-ready に到達する。 |
done |
done-ready のクローズアウト後、終端状態をアーカイブする。 |
slipway run はショートカットのドライバです。オペレーターに判断を委ねる停止地点、つまりスキルのハンドオフ、ブロッカー、または done-ready 状態に達するまで処理を進めます。
変更前は読み取り専用で
Section titled “変更前は読み取り専用で”読み取り専用コマンドを使って現在の状態を把握します。
slipway status --jsonslipway validateslipway next --json --diagnostics把握したうえで、指定のステージコマンドを実行するか、提示されたスキルを完了させます。これにより、エージェントが古いコンテキストから推測することを防ぎます。
フェイルクローズ型のリカバリ
Section titled “フェイルクローズ型のリカバリ”フェイルクローズ型のブロッカーは、現在のワークトリーにおける証明のいずれかが、欠落している、古い、不正な形式である、またはスコープ外であることを意味します。適切なリカバリは次のいずれかです。
slipway instructions <artifact>をもとに、欠落しているアーティファクトを記述する。- 担当ステージまたは選定したレビュアーを、新しいコンテキストで再実行する。
- ウェーブ実行のパスを通じてタスクエビデンスを記録する。
health --doctorが指定したときに限り、範囲を限定したローカルの修復を実行する。- 目的が変わった場合は、新しいガバナンス対象の変更を開始する。
不適切なリカバリは、状態ファイルを手で編集する、タイムスタンプを変更する、新しい証明なしにブロッカーを取り除く、あるいはエージェントにレビューの回避を教え込む、といったものです。
done-ready は done ではない
Section titled “done-ready は done ではない”done-ready とは、ゲートがすべて通過し、変更を確定できる状態を指します。slipway done は終端状態をアーカイブします。done がワークトリーの汚れ（dirty-worktree）に関する警告を報告した場合は、意図した実装差分とアーカイブされた Slipway レコードをまとめてコミットしてから、ワークトリーを削除します。