unity-mcp-server CLAUDE.md

CLAUDE.md

このファイルは、このリポジトリでコードを扱う際のガイダンスを提供します。

開発指針

🛠️ 技術実装指針

• 設計・実装は複雑にせずに、シンプルさの極限を追求してください
• ただし、ユーザビリティと開発者体験の品質は決して妥協しない
• 実装はシンプルに、開発者体験は最高品質に
• CLI操作の直感性と効率性を技術的複雑さより優先

📝 設計ガイドライン

• 設計に関するドキュメントには、ソースコードを書かないこと

開発品質

完了条件

• エラーが発生している状態で完了としないこと。必ずエラーが解消された時点で完了とする。

開発ワークフロー

基本ルール

• 作業（タスク）を完了したら、変更点を日本語でコミットログに追加して、コミット＆プッシュを必ず行う
• この環境には git と gh コマンドが揃っているため、push や PR 作成は git push や gh pr create などを用いて自力で実行し、「できない」と言い訳しないこと
• 作業（タスク）は、最大限の並列化をして進める
• 作業（タスク）は、最大限の細分化をしてToDoに登録する
• 作業（タスク）の開始前には、必ずToDoを登録した後に作業を開始する
• 作業（タスク）は、忖度なしで進める

Spec駆動開発ライフサイクル

新機能の開発は、以下の3ステップで進めます：

1. /speckit.specify: 機能仕様書を作成 (specs/SPEC-[UUID8桁]/spec.md)

   • ビジネス要件とユーザーストーリーを定義
   • 「何を」「なぜ」に焦点を当てる（「どのように」は含めない）
   • SPECディレクトリを自動作成（specs/SPEC-xxxxxxxx/）
   • Gitブランチ/Worktreeは作成しない（必要なら手動運用）

2. /speckit.plan: 実装計画を作成 (specs/SPEC-[UUID8桁]/plan.md)

   • 技術スタック、アーキテクチャ、データモデルを設計
   • 憲章チェック（TDD/LLM最適化/シンプルさの原則）
   • Phase 0: 技術リサーチ (research.md)
   • Phase 1: 設計とコントラクト (data-model.md, contracts/, quickstart.md)
   • Phase 2: タスク計画 (tasks.md)

3. /speckit.tasks: 実行可能なタスクに分解 (specs/SPEC-[UUID8桁]/tasks.md)

   • Setup/Test/Core/Integration/Polishに分類
   • 並列実行可能なタスクに[P]マーク付与
   • 依存関係を明確化

Spec命名規則

• 形式: SPEC-[UUID8桁]
• UUID生成: ランダムな16進数（小文字）8桁（a-f0-9）
  • ✅ 正しい例: SPEC-a1b2c3d4, SPEC-3f8e9d2a, SPEC-7c4b1e5f
  • ❌ 間違い例: SPEC-001, SPEC-gameobj, SPEC-core-001
• 禁止事項:
  • 連番の使用（001, 002...）
  • 意味のある名前（gameobj, core, ui...）
  • 大文字の使用（UUID部分は小文字のみ）
• 生成方法: uuidgen | tr '[:upper:]' '[:lower:]' | cut -c1-8 またはオンラインUUID生成ツール

ブランチ運用（任意）

Speckitは要件ディレクトリ（specs/SPEC-xxxxxxxx/）のみを作成し、Gitブランチ/Worktreeは作成しません。

現在の作業対象要件の選択:

• /speckit.specify 実行時に、対象の FEATURE_ID が .specify/current-feature に保存されます。
• 以降の /speckit.plan・/speckit.tasks などは、この値を参照して specs/SPEC-xxxxxxxx/ を特定します。
• 明示的に切り替えたい場合は、環境変数 SPECIFY_FEATURE=SPEC-xxxxxxxx を設定しても構いません。