grill-me-with-docs

grill-me スキルを使ってインタビューセッションを実施し、ドメイン用語、システムの境界、ドキュメントに関する判断に焦点を当てます。grill-me が利用できない場合は、REFERENCE.md のフォールバック手順に従って、直接インタビューを実施します。

使用するスキル

スキル	利用できない場合
grill-me	人に直接インタビューします。一度にひとつの質問を徹底的に行い、意思決定ツリーの各分岐を確認し、それぞれに推奨する回答を提示します。また、コードベースから回答できる質問についてはコードベースを調べます

ドメインの把握

このスキルでは、次の3つの継続的に更新されるドキュメントを作成、維持します。

ファイル	目的
LANGUAGE.md	ドメインの標準用語 — 用語の意味を定義します。実装の詳細は含めず、用語集のみを記載します。
MAP.md	簡潔なシステムマップ — 各要素の場所と相互のつながりを示します。限られたコンテキストしか持たないエージェントや開発者が、システム全体を把握するための参考資料です。
docs/decisions/	変更が難しい、意外性がある、または実際にトレードオフを伴う判断を記録します。

ファイル構成

/
├── LANGUAGE.md          ← domain glossary
├── MAP.md               ← system map
├── docs/
│   └── decisions/
│       └── 0001-*.md
└── src/

ファイルは、記載する内容ができたときにのみ作成します。REFERENCE.md で複数コンテキストにおける構成を確認してください。

セッション中

用語を LANGUAGE.md と照らし合わせて検討し、曖昧な表現を明確にし、具体的なシナリオについて話し合い、主張をコードと照合します。詳しいセッションの進め方については、REFERENCE.md を参照してください。

LANGUAGE.md をその場で更新する

用語の意味が確定したら、その場で LANGUAGE.md を更新します。後でまとめて更新せず、決まり次第記録してください。LANGUAGE-FORMAT.md の形式を使います。

LANGUAGE.md は用語集のみを記載するファイルです。実装の詳細や判断は記載しません。

新しいインターフェースを検証する

新しいコンポーネント、モジュール、UI、API サーフェス、CLI コマンドを作成する前に、次の手順を実施します。

1. MAP.md を確認し、同等のものがすでに存在するか調べます
2. コードベースを確認し、同等のものがすでに存在するか調べます
3. すでに存在する場合は、「これはすでに X として存在するようです。新しく作成する意図はありますか？」と尋ねます
4. 作成することが確認された場合は、既存のものにはないどのような機能を持つのかを尋ねてから、MAP.md を更新します

MAP-FORMAT.md の形式を使います。

MAP.md をその場で更新する

次のいずれかに該当した場合は、直ちに MAP.md を更新します。

• 新しいコンポーネント、UI、または関連システムが特定または確認された
• 検証の結果、MAP.md の項目に修正が必要だと判明した
• セッション終了時 — 話し合ったものの、まだ記録されていない内容がないか MAP.md を確認します

判断の提示は慎重に行う

変更が難しく、背景情報なしでは意外性があり、実際のトレードオフの結果として生じる場合に限り、判断の記録を提案します。基準と形式の詳細については、DECISIONS.md を参照してください。

セッション終了時

作成または更新したすべてのファイルを含め、最終的なファイル構成を出力します。

/
├── LANGUAGE.md                               ← updated
├── MAP.md                                    ← updated
├── docs/
│   └── decisions/
│       └── 0001-example-decision.md          ← created
└── src/