概要
- Claudeに関する 過去のベストプラクティスの神話化 と 最新の運用方法 の比較
- ルール重視から判断重視 への転換
- 例示からインターフェース設計 へのシフト
- 情報の一括提示から段階的開示 への進化
- シンプルな仕様から豊富な参照情報 への拡張
Claude運用のベストプラクティス：過去と現在
-
従来：Claudeへ厳格なルール提示 最新：Claudeの判断力を信頼
- 以前は 誤操作防止 のため詳細なルールを与えていた
- 例：コメントは1行のみ、マルチライン禁止などの強い指示
- 実際には ユーザーや状況により柔軟な対応が必要
- 新モデルは判断力向上、明示的ルール不要で適切な判断が可能
-
従来：具体例の提示 最新：ツールやファイルのインターフェース設計
- 例示による誘導は 探索範囲を制限
- パラメータや状態（例：pending, in_progress, completedなど）を列挙し Claudeに利用方法を示唆
- インターフェース設計重視 への転換
-
従来：全情報の一括提示 最新：段階的開示（progressive disclosure）
- 以前は コードレビューや検証手順を全て最初に提示
- 現在は 必要時のみスキルやツールを呼び出し
- ツールの遅延読み込み や ファイルのツリー構造化 による効率化
-
従来：繰り返し指示 最新：シンプルなツール記述
- 以前は ツール説明を複数箇所に記載
- 現在は ツール説明内に利用方法を集約 し、重複排除
-
従来：CLAUDE.mdへの手動メモリ保存 最新：自動メモリ保存
- Claudeが自動的に関連情報を記憶
-
従来：シンプルな仕様ファイル 最新：リッチな参照情報
- Markdownファイルやテストスイート、HTMLアーティファクトなど多様な参照
- Rubric（評価基準） による動的ワークフローや検証
Claudeの文脈設計への応用
-
System Prompt
- プロダクト文脈に強く依存
- Claudeが どのプロダクトで何をするか を明示
- 独自エージェント開発時は 特に重要
-
CLAUDE.md
- 軽量化推奨、リポジトリの目的のみ簡潔に記載
- コードベース固有の注意点 にトークンを割り当て
- 段階的開示 の徹底、検証スキルなどは分離して参照
-
Skills
- Claudeが 必要時に参照できる軽量ガイド
- 過剰な制約は避ける、重要分野のみ厳格化
- 長いスキルは分割し、段階的開示推奨
- チームやプロダクト固有の知識・ノウハウ のエンコード
-
References（参照）
- @メンションでファイル参照 が可能
- 仕様書、モックアップ、コードベースなど 高精度な情報源 を優先
- HTMLモックアップ＞テキスト説明＞スクリーンショット の順で精度向上
-
シンプル化の推奨
- claude doctorコマンド で自動的にシンプル化も可能
- Fable field guide でさらに詳細なプロンプト設計を学習可能
まとめ
- Claude運用は ルール重視から判断重視、例示から設計重視 へと進化
- 段階的開示・自動メモリ・リッチな参照 の活用が鍵
- シンプルかつ柔軟な文脈設計 が最新のベストプラクティス