agentleFS
takayoshitoyoda05takayoshitoyoda05/claude-ml-template/.claude/skills/design-interview/SKILL.md

design-interview

Skill1 starsChanged 2 months agoMITView on GitHub

実装前に設計を固めるとき、「詰めて」「深掘りして」と言われたときに必ず使う。

4 other projects use a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

設計インタビュー

ユーザーの設計書・計画を、実装に入る前に徹底的に問い詰め、認識のズレをなくす。

進め方

大原則(no-guess): 設計書の空欄・曖昧箇所を、もっともらしい内容で 勝手に埋めない。埋める内容は必ずユーザーへの質問から得る。 ユーザーが「お任せする」と明示した場合のみ、推奨案を提示して確認を取ってから 記入する(確認なしの記入は禁止)。

  1. 作業スコープ直下に CONTEXT.md があれば先に読み、用語の解釈をそれに合わせる。
  2. 対象の設計書(通常は docs/drafts/ 配下)を読み込む。指定がなければ、直近の 会話や docs/drafts/ の中から対象を確認する。
  3. 決定木を1枝ずつ辿る。各分岐で、未確定な判断を1つ特定する。 決定どうしに依存があるときは、前提となる決定から順に解く。 前提が未確定のまま後続の質問を出さない(答えが前提次第で変わる質問は、 ユーザーを迷わせるだけで情報が得られない)。
  4. 未確定な判断を探すとき、以下の曖昧性タクソノミーを網羅の基準にする。 全カテゴリについて「設計書に答えが書いてあるか」を確認し、 書かれていないカテゴリから質問を作る。

    詳細は .claude/skills/design-interview/references/ambiguity-taxonomy.md を必ず読むこと(この節の規律は参照先が正)。

  5. 質問は必ず1問ずつ出す。複数の質問を同時に出さない。
  6. 各質問には、こちらの推奨案を添える(例:「Aが良いと考えます、理由は〜」)。
  7. 事実と決定を分ける。環境(ファイルシステム・コマンド・既存ドキュメント)を 調べれば分かる事実は、ユーザーに聞かず自分で調べて埋める。 決定はユーザーのものなので、必ず1つずつ出して回答を待つ。 事実だと思って推測で埋めない。調べて分からなければ、それは決定として出す。
  8. ユーザーの回答を待ってから次の質問に進む。 8.5. すべての分岐が解消したと自分で判断したら、確定した決定の一覧を ユーザーに提示し、「これで揃ったか」を確認する。 ユーザーが揃ったと答えるまで、設計書を書き始めない。 「まだある」と言われたら手順3に戻る。 分岐が解消したかの判定をエージェント自身で完結させないこと。自己判定で 早く切り上げると、聞き漏らした決定を推測で埋めた設計書ができ、後段の spec-checklist で差し戻される。
  9. 手順8.5 の確認が取れたら、決定内容を設計書(docs/drafts/配下)に反映して 更新する。このとき「## 受け入れ条件」セクションを必須で生成する(無ければ新規作成、 あれば決定事項を反映して更新)。全ての決定を、以下の6列を持つ Markdown テーブルの 検証可能な要件に変換する(このテーブルなしでは Planner が計画作成を差し戻す)。

    詳細は .claude/skills/design-interview/references/acceptance-criteria.md を必ず読むこと(この節の規律は参照先が正)。

呼び出しコンテキストによる分岐

詳細は .claude/skills/design-interview/references/call-contexts.md を必ず読むこと(この節の規律は参照先が正)。

知識の自動スタック(手順9の直後に必ず実施する)

詳細は .claude/skills/design-interview/references/knowledge-stacking.md を必ず読むこと(この節の規律は参照先が正)。

完了時

  1. 固まった設計書を docs/active/ に移動する準備が整ったことをユーザーに 伝える(実際の移動は Planner が /ml-pipeline 実行時に行う)。

対象範囲

コードの設計に限らず、論文の論理構成、スライドの構成、実験計画など、 意思決定が必要な文書全般に使ってよい。ML/コードに限定しない。

注意

  • スコープ外のファイルを編集しない。CLAUDE_WORK_SCOPE に従う。
  • 知識の自動スタックで CONTEXT.md が肥大化しないよう、繰り返し使われる 概念だけを厳選する。判断に迷ったら追記しない。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.