spec

name	spec
description	曖昧な要望や課題を、実装に入れる前の明確な仕様へ固める。要望がふわっとしている時、何を作るか合意が要る時、plan に入る前に使う。

Spec

決まっていない機能仕様やふわっとした要望を、検証可能な受け入れ基準とスコープを持つ仕様へ固める。

Use when

• 何を作るかが言葉で曖昧なまま着手しそうなとき
• 要望と「本当に欲しいもの」がずれていそうなとき

Procedure

1. 解く課題を1文で書く。 誰の・どんな困りごとを解消するのかを言語化する。解決策ではなく課題を書く。
2. 受け入れ基準を並べる。 「完成」を観測可能（テストできる）な条件の箇条書きにする。
3. スコープを切る。 やること／やらないことを明示する。今回やらないものを必ず書く。
4. 未確定を潰す。 不明点を洗い出し、質問で確かめるか「前提」として明記する。曖昧なまま残さない。
5. 仕様をドキュメントとして残す。 CLAUDE.mdで特別な指示がない限り、{repo_root}/docs/spec に markdown ファイルとして残す

Hand off

• 仕様が固まったら plan へ。

Done when

• 解く課題が1文で書けている
• 受け入れ基準が観測可能（テスト可能）
• スコープ外が明示されている
• 未確定が前提化または解消されている
• 仕様がドキュメントとして残されている