design-workflow

interview method に従って、出力がワークフロー仕様となるよう、状態を保持したインタビューを実施します。語彙と目標は以下のとおりです。依存関係を考慮した質問ラウンドと推奨回答を用います。決定が固まったら仕様を作成・更新し、置き換え後の仕様と有用な履歴を保持できる場合にのみ、古くなった仕様を削除します。

ループという視点

ループとは、ユーザーの人生における繰り返しのパターンです。キャリア、1週間、朝の時間、繰り返し行う1つの作業などが該当します。ループが入れ子になったものとして人生を捉えると、活動がどれほど予測可能かが見えてきます。だからこそ、それらを委任する価値があります。この視点で仕様化する価値のあるループを見つけ、ユーザーがまだ気づいていないループも提案します。

ワークフローとは、1つのループを仕様化し、実際に動かせるようにしたものです。ループに対してワークフローを実行します。ループは、そのワークフローが実行される具体的な形です。ワークフローは workflows/*.md に保存し、信頼できる唯一の情報源とします。

用語

共有言語として、ワークフローで必要になったときにのみ使います。チェックリストにはしません。構造を一切必須にしません。問い詰めた結果、必要だと分からない限り、ワークフローに AI も、チェックポイントも、スケジュールも必要ありません。

• トリガー：各実行を開始するものです。イベント（新しいメール、新しい issue など）またはスケジュール（毎朝など）があります。通常、イベントをトリガーとするほうが効率的です。
• チェックポイント：ユーザーに確認や判断を求める、人間が介在する箇所です。チェックポイントがなく自律的に実行されるワークフローもあれば、AI を一切使わないワークフローもあります。
• 確認をできるだけ後回しにする：チェックポイントを可能な限り遅らせます。人間が関わる前に最大限の作業を済ませ、すべてを準備したうえで、最後に一度だけ確認してもらいます。
• ブリーフ：チェックポイントで提示する、簡潔で判断しやすい要約です。何が作成されたか、その理由、成果物そのものへのリンクを含めます。生の出力は提示しません。ユーザーが読むのはブリーフであり、草稿ではありません。確認の速さが最優先です。

完了の定義

実装エージェントが質問を1つもせずに構築できる状態になったら、ワークフロー仕様は完成です。その状態になるまで徹底的に問い詰めます。質問が残っている限り、完了ではありません。

ワークスペース

• workflows/*.md：ワークフローごとに1つの仕様を保存します。
• NOTES.md：ユーザーの環境、使用するツール、処理するチャネル、それらに対するユーザー独自の用語についての未整理のメモです。内容が空または不十分な場合は、何かを仕様化する前に、ユーザーの環境についてインタビューします。曖昧な用語が出てきたら、明確な標準用語に整え、ここに記録します。