grill-with-docs

Skill ツールを「grilling」で呼び出します。決定事項が固まってきたら、プロジェクトのドメイン文書をその場で作成・改善してください。GLOSSARY.md に用語を追加または明確化し、重要なトレードオフは docs/adr/ に ADR として記録します。

セッションで書き込むファイルは、これらの文書だけです。テーマは機能そのもの、つまり、機能が何をするのか、誰を対象にしているのか、そしてその背景にある決定事項です。作業内容の文書化は別の担当者が行います。仕様書は to-spec が作成し、チケットは to-tickets が作成します。解決すべき課題がなくなったら、この機能はそのいずれかに進める状態だと伝え、そこで終了してください。

平易な言葉で話してください。専門用語より日常的な言葉を優先し、用語は最初に出てくるときに正式名称で書き、ユーザーに意味が伝わらない可能性のある名前には、一行の説明を添えてください。