Ask Matt
すべてのスキルを覚えておく必要はありません。尋ねてください。
フローとは、スキルをたどる経路です。ほとんどの経路は1つのメインフローに沿って進み、2つのオンランプがそれに合流します。それ以外はすべてスタンドアロンです。
メインフロー: アイデア → 出荷
ほとんどの作業がたどるルートです。アイデアがあり、それを構築したい場合に使います。
/grill-with-docs— インタビュー形式でアイデアを具体化します。コードベースがある場合にここから始めます。ステートフルで、学習した内容をCONTEXT.mdやADRに保持します。（コードベースがない場合は/grill-meを使用してください。スタンドアロンを参照。）- 分岐 — すべての質問を会話だけで解決できますか？ 実行可能な回答（状態、ビジネスロジック、実際に見る必要があるUI）を必要とする質問がある場合は、プロトタイプ経由で迂回し、その両方向を
/handoffで橋渡しします（セッションの横断を参照）：/handoffで出て、そのファイルに対して新しいセッションを開き、/prototypeで使い捨てのコードを使って質問に答え、/handoffで学んだことを戻し、元のアイデアスレッドから参照します。
- 分岐 — これは複数セッションにわたる構築ですか？
- はい →
/to-prd（スレッドをPRDに変換）→/to-issues（PRDを独立して取得可能なIssueに分割）。Issueは独立しているため、各Issue間でコンテキストをクリアにします。Issueごとに新しいセッションを開始し、/implementを起動する際にはPRDと作業対象の単一Issueを渡します。 - いいえ → 同じコンテキストウィンドウ内でここで
/implementを実行します。
- はい →
コンテキスト衛生
ステップ1～3は1つの切れ目のないコンテキストウィンドウ内に保持します — /to-issues が終わるまではコンパクト化やクリアをしないでください — そうすることで、グリル、PRD、Issueすべてが同じ思考に基づいて構築されます。その後、各 /implement は新しい状態で開始し、Issueから作業を行います。
この制限は**スマートゾーン**、つまりモデルが依然として鋭く推論できるウィンドウ（最先端モデルで約120kトークン）に基づきます。セッションが /to-issues の前にそれに近づいた場合、劣化した状態で押し進めず、/handoff を使用して新しいスレッドで続行します。
オンランプ
作業を生成し、その後メインフローに合流する開始状況です。
-
バグやリクエストが山積み →
/triage。Issueをトリアージロールを通じて処理し、エージェント対応可能なIssueを生成します。これらは後で/implementが取得します。トリアージは自分で作成していないIssue — バグレポート、受信した機能リクエスト、生の状態で届くもの — にのみ使用します。
/to-issuesが生成したIssueはすでにエージェント対応済みなので、トリアージしないでください。
コードベースの健全性
機能作業ではなく、保守です。
/improve-codebase-architecture— エージェントが操作しやすいコードベースを維持するために、少し時間ができたときにいつでも実行します。改善の機会を表面化し、1つを選ぶとアイデアが生成され、それをメインフローの/grill-with-docsに持ち込めます。
セッションの横断
/handoff— スレッドがいっぱいになったとき、または分岐が必要なとき（例：/prototypeセッションへの分岐）に、会話をマークダウンファイルにコンパクト化します。その場で続行するのではなく、新しいセッションを開いてそのファイルを参照し、コンテキストを引き継ぎます。これはコンテキストウィンドウ間の橋渡しであり、双方向に機能します。新しいセッションが必要だが現在の会話を保持したい場合に使用します。/compact（組み込み）— 同じ会話にとどまり、以前のターンを要約します。フェーズ間の意図的な区切りで使用し、逐語的な履歴が失われても構わない場合に使います。フェーズの途中でコンパクト化しないでください — エージェントが迷子になる可能性があります。/handoffは分岐し、/compactは継続します。
スタンドアロン
メインフローから完全に外れたものです。
/grill-me—/grill-with-docsと同じ執拗なインタビューですが、コードベースがない場合に使用します。ステートレスで、ローカルに何も保存せず、CONTEXT.mdも構築しません。リポジトリに存在しない計画や設計を具体化するために利用します。/teach— 現在のディレクトリをステートフルなワークスペースとして使用し、複数セッションにわたって概念を学習します。/writing-great-skills— スキルを適切に作成および編集するためのリファレンスです。
前提条件
/setup-matt-pocock-skills — 最初のエンジニアリングフローの前に実行し、他のスキルが前提とするIssueトラッカー、トリアージラベル、ドキュメントレイアウトを設定します。カスタムIssueトラッカーも動作します。