Project Memory

このファイルは、このプロジェクトでClaude Codeに最初に共有したい前提をまとめるためのテンプレートです。 [TODO]のままでも動きますが、具体的に書くほど精度が上がります。

Project Overview

• プロジェクト名: [TODO]
• 一言説明: [TODO: 何を作るプロダクトか]
• 主な利用者: [TODO]
• 現在の優先事項: [TODO]

Tech Stack

• 言語: [TODO]
• フレームワーク: [TODO]
• パッケージマネージャ: [TODO]
• テスト: [TODO]
• Linter/Formatter: [TODO]

Common Commands

Claude Codeは変更前後で、ここに書かれたコマンドを優先して使ってください。

• セットアップ: [TODO]
• 開発サーバー: [TODO]
• テスト: [TODO]
• Lint: [TODO]
• 型チェック: [TODO]
• ビルド: [TODO]

Directory Map

• src/: [TODO]
• tests/: [TODO]
• docs/: [TODO]
• scripts/: [TODO]

必要なら、重要ディレクトリを追加してください。

Working Agreement

• 変更前に関連ファイルを読んでから編集する
• 影響範囲が広い変更は、先に短い実装方針を示す
• 変更後は、可能な範囲でテスト、lint、型チェックを行う
• 実装方針や仕様が変わったら、READMEやdocsも必要に応じて更新する
• 無関係なリファクタは混ぜない

Coding Preferences

• 1回の変更はできるだけ小さく保つ
• 命名は既存コードの流儀に合わせる
• コメントは「なぜ必要か」が分からない箇所だけに絞る
• エラーハンドリングを省略しない

When Unsure

• 要件が曖昧なら、勝手に大きく作り込まず、選択肢とトレードオフを短く示す
• テスト方法が不明なら、まず既存のテスト構成を探す
• 既存ルールと依頼内容が衝突するときは、衝突点を明示して確認する

Recommended Skills

• 要件整理: /intake-task
• 機能追加: /feature-workflow
• 不具合修正: /bugfix-workflow
• ドキュメント更新: /docs-sync

Notes For The Team

• このファイルは「人のための仕様書」ではなく「Claude Codeに毎回渡す実務メモ」です
• 長くしすぎると毎回の文脈を圧迫するため、重要な事実だけを残してください
• 詳しい背景説明は docs/ に書き、ここから参照先を示す運用がおすすめです