Recipes

Recipes - 作業方法・方針雛形集

Claudeとの作業において頻繁に利用する作業方法や方針の雛形を目的別に整理・保存するディレクトリです。

概要

目的: プロジェクト作成・管理時の一貫した作業方法を確立し、効率的で品質の高い開発を実現する

対象範囲:

• プロジェクト作成時の初期設定手順
• 開発フロー・方針テンプレート
• ドキュメント作成・管理方針
• 品質管理・テスト戦略
• デプロイ・運用方針

ディレクトリ構造

recipes/
├── README.md                    # 本ファイル - 全体概要とインデックス
├── document-code-test/          # ドキュメント・コード・テストの三位一体同期管理
├── npm-workspaces-typescript/   # npm workspaces x TypeScript設定ガイド
├── serena-integration/          # Serenaコード解析ツールの導入・設定
└── testing/                     # テスト戦略・分類・実装指針

利用方法

新しいレシピの作成

1. 目的に応じて適切なカテゴリディレクトリを選択
2. {purpose}-{description}.md 形式でファイル作成
3. テンプレート形式で具体的な手順・方針を記述

既存レシピの活用

1. 目的に合致するレシピを検索・選択
2. プロジェクトの特性に合わせてカスタマイズ
3. 実践後の改善点をレシピにフィードバック

レシピ作成ガイドライン

記述原則

• 具体性: 抽象的でなく実行可能な手順
• 再現性: 誰でも同じ結果を得られる明確性
• 保守性: 変化に対応できる柔軟な構造
• 効率性: 無駄のない最適化された手順

テンプレート構成

# [レシピ名]

## 目的
[何を達成するためのレシピか]

## 前提条件
[必要な環境・知識・ツール]

## 手順
[具体的なステップバイステップ手順]

## 期待する成果
[完了時に得られる結果]

## 注意点・制約
[注意すべき点や制約事項]

## 関連レシピ
[関連する他のレシピへのリンク]

現在のレシピ

document-code-test/

ドキュメント・コード・テストの三位一体同期管理

• DOCUMENT_CODE_TEST_SYNC.md - ドキュメント・コード・テストの三位一体同期管理方針
  • 三要素の同期戦略と「正」の判定基準
  • 不一致パターンの検出と解決手順
  • トレーサビリティ確保のためのコメント・テストタイトル方針

npm-workspaces-typescript/

npm workspacesとTypeScript Project References連携ガイド

• setup-guide.md - モノレポ環境の正しい設定方法
  • 二つの依存関係グラフ（ランタイム/コンパイルタイム）の理解
  • ルート/パッケージレベルの具体的な設定例
  • npm操作の実行場所と-wフラグの重要性
  • トラブルシューティングと自動化ツール

testing/

テスト戦略・分類・実装指針

• TEST_CLASSIFICATION.md - テストの分類と基本方針
  • ユニット/インターフェース/統合/システム/E2Eテストの定義
  • 各テストレベルの責任範囲と実装指針
  • モック使用方針とセットアップパターン

serena-integration/

Serenaコード解析・編集ツールの導入と設定

• SERENA_PROJECT_SETUP.md - プロジェクトへのSerena導入手順
  • Claude Codeとの統合設定（自動アクティベート対応）
  • ブラウザ自動起動の無効化設定
  • 大規模プロジェクトのインデックス作成
  • プロジェクト固有の設定とトラブルシューティング

---

作成日: 2025年8月12日 最終更新: 2025年10月22日
管理者: Claude Code User

関連ファイル:

• ~/.claude/CLAUDE.md - 個人作業指針
• ~/.claude/TECH_NOTES.md - 技術開発ノート