開発ワークフローにAIアシスタントを統合するための包括的なガイド。 これらのテンプレートは、異なるAIモデルと人間の開発者の間で一貫した効果的なコラボレーションを確立するのに役立ちます。

ドキュメント構造

コアガイドライン

• CLAUDE.md - クロードコードと同様のAIアシスタントのガイドライン
• ルート原因解析方法論
• 一般的な間違いとそれらを避ける方法
• マルチモデルコラボレーションパターン
• MCPサーバーの統合(利用可能な場合)
• プロジェクト固有の構成テンプレート

-AGENTS.md - マルチエージェントコラボレーションフレームワーク

• エージェントの役割と強み

• アシスタント間のハンドオフプロトコル

• タスク委任パターン

• コラボレーションワークフロー

• MCP SETUP.md - MCPサーバーセットアップガイド

• 1行のCodexのセットアップ

• 他のMCPサーバーを追加する

• セキュリティオプション

• トラブルシューティング

設定例

• mcp-config-example.json - シンプルなMCP設定テンプレート
• .env.example - 環境変数のテンプレート

すぐにスタート

##1. MCPインテグレーションを有効にする (ワンコマンド!)

##2. クイックスモークテスト(60秒)

すぐに統合をテストして下さい:

1. クラウデでは、「コーデックスを使ってテストファイルを作成することはできますか?

AI Assistant Documentation Hub

A comprehensive guide for integrating AI assistants into your development workflow. These templates help establish consistent, effective collaboration between different AI models and human developers.

📚 Documentation Structure

Core Guidelines

• CLAUDE.md - Guidelines for Claude Code and similar AI assistants

  • Root cause analysis methodology
  • Common mistakes and how to avoid them
  • Multi-model collaboration patterns
  • MCP server integration (when available)
  • Project-specific configuration template

• AGENTS.md - Multi-agent collaboration framework

  • Agent roles and strengths
  • Hand-off protocols between assistants
  • Task delegation patterns
  • Collaboration workflows

• MCP_SETUP.md - MCP server setup guide

  • One-line Codex setup
  • Adding other MCP servers
  • Security options
  • Troubleshooting

Configuration Examples

• mcp-config-example.json - Simple MCP config template
• .env.example - Environment variables template

🚀 Quick Start

1. Enable MCP Integration (One Command!)

# Install Codex CLI (choose your preferred method)
npm install -g @openai/codex       # via npm
brew install --cask codex          # via Homebrew (macOS)

# Sign in with your ChatGPT account (Plus/Pro/Team/Edu/Enterprise plans)
codex  # then select "Sign in with ChatGPT"
# OR set your OpenAI API key for API key auth:
# export OPENAI_API_KEY=sk-...

# Add Codex MCP server to Claude (macOS/Linux)
claude mcp add codex -s user -e OPENAI_API_KEY=$OPENAI_API_KEY -- codex mcp -c model=gpt-5.3 -c model_reasoning_effort="high"

# Windows PowerShell variant
claude mcp add codex -s user -e OPENAI_API_KEY=$env:OPENAI_API_KEY -- codex mcp -c model=gpt-5.3 -c model_reasoning_effort="high"

# Restart Claude Desktop - Done! 🎉

2. Quick Smoke Test (60 seconds)

Test the integration immediately:

1. In Claude, ask: “Can you work with Codex to create a test file?”
2. Claude should delegate to Codex to:
   • Create test-codex-integration.txt with “Hello from Codex!”
   • Show the file contents
   • Delete the file
3. Success = file created, shown, and removed with no other changes

3. Copy Templates to Your Project

# Clone or download these templates
cp -r docs/ai-assistants /path/to/your/project/docs/

# Customize for your project
cd /path/to/your/project/docs/ai-assistants

4. Configure for Your Project

Edit the configuration section in CLAUDE.md:

# In CLAUDE.md - Add your project details
project:
  name: "Your Project Name"
  type: "web|cli|library|service"
  language: "TypeScript|Python|Go|etc"
  
conventions:
  style_guide: "link-to-style-guide"
  test_framework: "jest|pytest|etc"
  min_coverage: 80

🤝 Collaboration Protocol

Working with AI Assistants

1. Primary Orchestrator (Claude Code or similar)