Living Documentation Hub

ステップ1 – Craftでドキュメントを整理する

Craftで階層的なドキュメント構造を作成します：

• メインの概要ページ – 高レベルのアーキテクチャとシステム設計
• サービスごとのサブページ – 各マイクロサービス用のページ：
  • サービスの説明と目的
  • APIエンドポイントとスキーマ
  • データベースモデル
  • 重要な実装の詳細
  • 依存関係と接続
  • コード例と使用パターン

AIが確実に解析できるように一貫した構造にします。

ステップ2 – 包括的な詳細を含める

各サービスについてドキュメント化します：

• 機能 – サービスの目的の明確な説明
• 接続方法 – 他のサービスとの関係
• APIドキュメント – エンドポイント、パラメータ、レスポンス
• データベーススキーマ – テーブル、関係、重要フィールド
• コード例 – 使用方法の実例
• 一般的なパターン – 開発者が通常どのように利用するか

ステップ3 – Craft MCPを有効化する

CraftのMCP（Model Context Protocol）接続をClaudeに設定します。これによりClaudeはIDEを通じてドキュメント構造全体を読み取ることができます。

ステップ4 – ClaudeでCursorをAIアップする

Cursor（またはClaude統合がある好みのIDE）で：

• ClaudeをAIアシスタントとして有効化する
• Craft MCPドキュメントに接続する
• 質問に答える際にドキュメントを読むよう設定する

ステップ5 – Claude用のカスタム指示を作成する

Cursorのセットアップに指示を追加します：

ステップ6 – 質問を始める

開発者はIDEから直接質問できます：

ステップ7 – ドキュメントを最新の状態に保つ

コードベースの進化に合わせてCraftドキュメントを維持します：

• アーキテクチャが変更されたらサービスの説明を更新する
• 新しいAPIエンドポイントが作成されたら追加する
• 新しいパターンと一般的な解決策をドキュメント化する
• 実際のコードに合わせて例を最新の状態に保つ

ドキュメントは信頼できる唯一の情報源であり続け、Claudeは常に最新のコンテキストを持ちます。

クリエイターが気づく影響

完成形

Craftドキュメントがチームのインテリジェンスハブになります。開発者がIDEから直接質問できるAIクエリ可能なナレッジベースです。検索したり、同僚に質問したり、コードを読んだりする代わりに、マイクロサービスアーキテクチャ全体にわたる完全なコンテキストとともに即座に正確な回答が得られます。