AI Assistants를 개발 워크플로우에 통합하는 종합 가이드입니다. 이 템플릿은 다른 AI 모델과 인간 개발자 간의 일관성, 효과적인 협업을 수립합니다.

핵심 가이드라인

• **CLAUDE.md ** - Claude Code 및 유사한 AI 조수를 위한 가이드라인

• 뿌리 원인 분석 방법론

• 일반적인 실수와 그들을 피하는 방법

• 멀티모델 협업 패턴

• MCP 서버 통합 (유효한 경우)

• Project-specific 설정 템플릿

• ** AGENTS.md** - 다중 시약 협력 프레임 워크

• 에이전트 역할과 힘

• 조수 사이 손 떨어져 의정서

• 작업 위임 패턴

• 협업 작업 흐름

• MCP SETUP.md - MCP 서버 설정 가이드

• 원라인 Codex 설정

• 다른 MCP 서버 추가

• 보안 옵션

• 문제 해결

구성 예제

• mcp-config-example.json - 간단한 MCP 설정 템플릿
• .env.example - 환경 변수 템플릿

⭐ 빠른 시작

##1. MCP 통합 활성화 (하나의 명령!)

2. 빠른 연기 시험 (60 초)

즉시 통합을 테스트:

1. 클로드에서 “코덱과 함께 테스트 파일을 만들 수 있습니까?”
2. 명세.

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)