tdd-tasknote

TDD開発の前にコンテキスト情報を収集し、開発に必要な情報をノートファイルにまとめます。

context

出力ディレクトリ="./docs/implements" 機能名={{feature_name}} タスクID={{task_id}} 要件名={{requirement_name}} 収集情報=[] noteファイル="./docs/implements/{要件名}/{{task_id}}/note.md"

step

• $ARGUMENTS がない場合、「引数に要件名とTASK-IDを指定してください（例: ユーザー認証機能 TASK-0001）」と言って終了する

• {{noteファイル}} が既にある場合、「すでに完了しています」といって終了する

• 開発コンテキストを収集する： 追加ルールの読み込み

  • AGENTS.md ファイルが存在する場合は読み込み
  • ./docs/rule ディレクトリが存在する場合は読み込み
  • ./docs/rule/tdd ディレクトリが存在する場合は、サブディレクトリを含む全ファイルを読み込み
    • ./docs/rule/tdd/red/, ./docs/rule/tdd/green/, ./docs/rule/tdd/refactor/, ./docs/rule/tdd/testcases/, ./docs/rule/tdd/verify-complete/ など全て対象
  • 各ディレクトリ内のすべてのファイルを読み込み、追加ルールとして適用

  Task tool (subagent_type: Explore, thoroughness: quick) を使用して実装関連情報を探索

  • ./docs/spec/{要件名}-requirements.md: 統合機能要件と関連文書へ
  • ./docs/spec/{要件名}-user-stories.md: 詳細なユーザストーリー
  • ./docs/spec/{要件名}-acceptance-criteria.md: 受け入れ基準とテスト項目
  • ./docs/spec/{要件名}-*.md: 受け入れ基準とテスト項目
  • 既存の類似機能やユーティリティ関数を探索
  • 実装パターンやアーキテクチャガイドラインを特定
  • 依存関係やインポートパスを確認
  • テスト関連情報の探索（後続フェーズで再探索不要にするため）:
    • テストフレームワークの設定ファイル（jest.config.js, playwright.config.js等）
    • 既存のテストファイルのパターンとディレクトリ構成
    • テストユーティリティやモック設定
    • E2Eテスト設定（UIタスクの場合）

  関連ファイルを直接読み込み

  • ./docs/implements/{要件名}/{{task_id}}/*.md - taskに関係する全てのファイルを読み込み
  • 関連する設計文書やタスクファイルも必要に応じて読み込み

• 収集した情報を整理して {{noteファイル}} に保存する

  • 重要: ノートファイル内のすべてのファイルパスは、プロジェクトルートからの相対パスで記載すること（絶対パスは使用しない）

rules

ファイル名のルール

出力ファイルのパス形式

• ./docs/implements/{要件名}/{{task_id}}/note.md
• 例: docs/implements/user-auth/task-0001/note.md

ファイル名の命名規則

• 機能名を簡潔な英語に変換する
• ケバブケース（kebab-case）を使用
• 最大50文字程度に収める
• 例:
  • "ユーザー認証機能" → "user-auth"
  • "データエクスポート機能" → "data-export"
  • "パスワードリセット機能" → "password-reset"

ファイルパスの記載ルール（必須）

• プロジェクトルートを基準とした相対パスを使用する
• 絶対パス（フルパス）は絶対に記載しない
• ディレクトリパスも相対パスで記載する
• 例:
  • ❌ /Users/username/projects/myapp/src/utils/helper.ts
  • ❌ /Users/username/projects/myapp/docs/spec/
  • ✅ src/utils/helper.ts
  • ✅ docs/spec/
  • ✅ backend/app/main.py
  • ✅ frontend/src/components/