groove-work-spec

groove-work-spec

指定されている場合は、$ARGUMENTS を仕様のトピックとして使用します。

成果

何を構築し、どのように検証するかを定義する完全な成果仕様です。手順はエージェントが決定します。

受け入れ基準

仕様ファイルに以下が含まれていること：

• 概要：何を構築するか、そしてその理由
• 決定事項：根拠を含む重要な技術的選択
• 実装手順：具体的で順序付けられた手順
• エッジケース：エラー処理、境界条件

制約

• トピックをファイル名として使用できるようにサニタイズします。パス区切り文字、特殊文字、パストラバーサルパターン（../）を除去します
• 仕様ディレクトリは常に .groove/memory/specs/ とします
• 仕様ディレクトリが存在することを確認します（なければ作成します）
• まずコードベースを調査します（Explore エージェントを使用します）
• 決定事項、エッジケース、テスト方針、スコープについてユーザーに質問します
• スコープを評価します。作業に自然な区切り（独立したコンポーネント、順次進行するフェーズ、分離可能な関心事）がある場合は、親仕様と子仕様に分割することを推奨します
  • 親仕様：機能全体の概要、子仕様へのリンク、順次実行する場合は実行順序
  • 子仕様：それぞれが独自の概要、決定事項、手順、エッジケースを備えた自己完結型の仕様
  • 命名：単一の仕様では <topic>.md、分割する場合は <topic>/index.md と <topic>/01-<part>.md
  • ユーザーが決定：分割案とその根拠を提示し、ユーザーに確認または変更してもらいます
• 分離されたコンテキストで仕様を作成します（汎用エージェントを使用します）
• 完了前に、必須セクションがすべて揃っていることを確認します
• 一般的な助言ではなく、実際のコードベースのパターンを参照します

品質指標

• 決定事項が実際のコードパターンを参照している
• 手順に実際のファイルパスと関数名が含まれている
• エッジケースが調査で判明した制約を反映している