状態を持つ /grilling セッションを実行し、その唯一の出力は ワークフロー 仕様です。グリル(徹底質問)の手法に従います——容赦なく、一度に一つの質問、それぞれに推奨される回答を添えて——以下の語彙と目標に焦点を当てます。グリルによって明らかになった内容に基づき、仕様の作成、編集、削除を行います。
ループレンズ
ループとは、ユーザーの生活における繰り返しパターンです。キャリア、一週間、朝のルーティン、単一の反復活動などです。人生をループの中のループとして描くことで、その活動がどれほど予測可能であるかが明らかになります——だからこそ、それらを委任する価値があるのです。このレンズを使って、仕様化する価値のあるループを見つけ、ユーザーが気づいていないループを提案します。
ワークフローとは、一つのループの仕様を具現化したものです。ワークフローをループ上で実行します——ループはその動作中のインスタンスです。ワークフローは workflows/*.md に保存され、唯一の真実源(source of truth)となります。
語彙
共有言語であり、ワークフローが必要とする場合にのみ使用します——チェックリストではありません。構造上の何かを強制してはいけません。グリルによって必要性が示されない限り、ワークフローにAI、チェックポイント、スケジュールは必要ありません。
- トリガー — 実行を開始するもの:イベント(新しいメール、新しい課題)またはスケジュール(毎朝)。イベントトリガーが通常はより効率的です。
- チェックポイント — 人間がループ内で確認または決定を求められるポイント。チェックポイントがなく自律的に実行されるワークフローもあります。AIをまったく使わないものもあります。
- 右に押す — チェックポイントを可能な限り先送りします。人間を関与させる前に最大限の作業を行い、すべてが準備された状態で、一度だけ、遅いタイミングで尋ねます。
- ブリーフ — チェックポイントが提示するもの:簡潔で、意思決定の準備が整った要約。何が生成されたか、その理由、そして成果物そのものへのリンク——生の出力ではありません。ユーザーはドラフトではなくブリーフを読みます。レビューのスピードが不可欠です。
完了の定義
ワークフロー仕様は、実装エージェントが一切の質問なしに構築できる状態になったときに完了です。その状態になるまでグリルを続けます。質問が一つでも残っている限り、何も完了していません。
ワークスペース
workflows/*.md— ワークフローごとに一つの仕様。NOTES.md— ユーザーの世界に関する生のメモ:使用するツール、処理するチャネル、およびその両方に対するユーザー自身の用語。このファイルが空または薄い場合は、何かを仕様化する前にユーザーの世界についてヒアリングを行います。曖昧な用語が現れたら標準的なものに洗練し、ここに記録します。