マッスル仕様書ビルダー｜AIコーディング実装仕様書ジェネレーター
こんな経験はありませんか
設計は固まった。要件も頭の中では整理できている。なのにCursorやClaude Codeに渡した瞬間、頼んでいないリファクタリングが始まったり、意図と違う実装になっていたり——手戻りが発生する。
原因はコードの書き方ではなく、多くの場合「仕様書の曖昧さ」にあります。人間同士なら「適切にハンドリングして」で通じても、AIコーディングエージェントにとっては実装のたびに違う解釈を生むバグの温床です。
マッスル仕様書ビルダーは、この曖昧さを機械的に検出し、AIが質問ゼロで着手できる仕様書に変換します。
できること
1. 曖昧語の検出と潰し込み
「適切に」「柔軟に」「必要に応じて」「〜など」「基本的に」——人間向けの説明では自然なこれらの言葉を検出し、具体的な条件・数値・列挙に置き換えます。
2. 非ゴールの明記でスコープ暴走を防止
「今回はやらないこと」を先に言語化することで、AIエージェントが勝手に隣接機能へ手を伸ばすのを防ぎます。頼んでいない変更が減ります。
3. 仮説先出しのインタビュー
情報が足りない時、ゼロから質問するのではなく「素材からこう推測しました、合っていますか」と仮説を提示します。訂正するだけで済むので、あなたの負担が小さく、思わぬ背景情報まで引き出せます。
4. トレードオフをADR(決定記録)として資産化
「AとBで迷ってAにした」という判断は、仕様書本文に埋もれさせず独立した記録として残します。選択肢の比較、決め手、再検討のトリガーまで構造化するので、なぜこうしたかが半年後も追跡できます。
5. 納品前の自動品質チェック
出力前に、曖昧語の残存、受け入れ条件の粒度、非ゴールの有無などをチェックリストで自己検査してから渡します。
出力される仕様書の中身
1つのMarkdownファイルに、以下がすべて含まれます。
- 背景・ゴール/非ゴール — 何を解決し、何をやらないか
- データモデル — 型、NULL可否、制約まで踏み込んだ定義
- 状態遷移・エッジケース — 同時実行、空データ、境界値などの挙動
- 受け入れ条件 — すべてGiven/When/Then形式で、機械的に真偽判定できる粒度
- フェーズ分割タスク — 各タスクに検証可能な完了条件つき
- ADR(必要な場合) — 設計判断のトレードオフと決定の記録
そのままCursorやClaude Codeに渡せば、実装エージェントが質問なしでPhase 1に着手できます。
使い方
- 作りたい機能の設計メモや壁打ちのログ、要件を貼り付けてください(断片的でも構いません)
- 情報が足りない箇所は、こちらから仮説つきで確認します
- 設計判断に迷いがあれば、選択肢と評価軸を提示します。決めるのはあなたです
- すべて出揃うと、実装エージェントにそのまま渡せる仕様書(必要に応じてADRも)が完成します
こんな人におすすめ
- 個人開発者、スタートアップのPM、テックリード
- AIに実装を任せると手戻りが多いと感じている方
- 設計の議論はできるが、それを実装仕様に落とし込む作業を効率化したい方
実際に「設計をClaudeで整理して仕様書化し、コーディングエージェントで実装する」というワークフローを回し続けている開発者が、その実運用ノウハウを体系化したツールです。
