메뉴
Create or update CLAUDE.md files following best practices for optimal AI agent onboarding
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Draft a blog post from ideas and resources. Use when users want to write a blog post, create content from research, or draft articles. Guides through research, brainstorming, outlining, and iterative drafting with version control.
Audit Claude Code guide content for factual accuracy by fetching the latest official documentation in real-time and comparing it against ko/ module markdown files. Checks settings paths, CLI syntax, hook events, permission modes, keyboard shortcuts, model IDs, and new features. Use this skill when asked to "check accuracy", "audit documentation", "verify content", "find outdated info", or after Claude Code releases a new version. Also trigger proactively after editing module content to catch regressions.
Ensure all communication matches brand voice and tone guidelines. Use when creating marketing copy, customer communications, public-facing content, or when users mention brand voice, tone, or writing style.
Comprehensive code review with security, performance, and quality analysis. Use when users ask to review code, analyze code quality, evaluate pull requests, or mention code review, security analysis, or performance optimization.
Generate comprehensive, accurate API documentation from source code. Use when creating or updating API documentation, generating OpenAPI specs, or when users mention API docs, endpoints, or documentation.
Systematic code refactoring based on Martin Fowler's methodology. Use when users ask to refactor code, improve code structure, reduce technical debt, clean up legacy code, eliminate code smells, or improve code maintainability. This skill guides through a phased approach with research, planning, and safe incremental implementation.
| name | claude-md |
| description | Create or update CLAUDE.md files following best practices for optimal AI agent onboarding |
$ARGUMENTS
진행하기 전에 사용자 입력을 반드시 고려해야 합니다 (비어있지 않은 경우). 사용자는 다음을 지정할 수 있습니다:
create - 새 CLAUDE.md를 처음부터 작성합니다update - 기존 CLAUDE.md를 개선합니다audit - 현재 CLAUDE.md 품질을 분석하고 보고합니다src/api/CLAUDE.md)LLM은 상태를 유지하지 않습니다: CLAUDE.md는 모든 대화에 자동으로 포함되는 유일한 파일입니다. AI 에이전트를 코드베이스에 온보딩하는 주요 문서 역할을 합니다.
적을수록 좋습니다: 프론티어 LLM은 ~150-200개의 지시사항을 따를 수 있습니다. Claude Code의 시스템 프롬프트는 이미 ~50개를 사용합니다. CLAUDE.md를 집중적이고 간결하게 유지하십시오.
보편적 적용 가능성: 모든 세션에 관련된 정보만 포함합니다. 작업별 지시사항은 별도 파일에 넣습니다.
Claude를 린터로 사용하지 마십시오: 스타일 가이드라인은 컨텍스트를 부풀리고 지시 따르기 성능을 저하시킵니다. 결정적 도구(prettier, eslint 등)를 대신 사용하십시오.
절대 자동 생성하지 마십시오: CLAUDE.md는 AI 하니스의 가장 높은 레버리지 포인트입니다. 신중한 고려를 통해 수동으로 작성하십시오.
먼저 현재 프로젝트 상태를 분석합니다:
기존 CLAUDE.md 파일을 확인합니다:
./CLAUDE.md 또는 .claude/CLAUDE.md**/CLAUDE.md~/.claude/CLAUDE.md프로젝트 구조를 파악합니다:
기존 문서를 검토합니다:
CLAUDE.md를 세 가지 차원으로 구조화합니다:
대규모 프로젝트의 경우 agent_docs/ 폴더 생성을 권장합니다:
agent_docs/
|- building_the_project.md
|- running_tests.md
|- code_conventions.md
|- architecture_decisions.md
CLAUDE.md에서 다음과 같은 지시사항으로 이 파일들을 참조합니다:
For detailed build instructions, refer to `agent_docs/building_the_project.md`
중요: 오래된 컨텍스트를 방지하기 위해 코드 조각 대신 file:line 참조를 사용하십시오.
CLAUDE.md를 생성하거나 업데이트할 때:
잘 구조화된 CLAUDE.md는 다음을 포함해야 합니다:
# Project Name
Brief one-line description.
## Tech Stack
- Primary language and version
- Key frameworks/libraries
- Database/storage (if any)
## Project Structure
[Only for monorepos or complex structures]
- `apps/` - Application entry points
- `packages/` - Shared libraries
## Development Commands
- Install: `command`
- Test: `command`
- Build: `command`
## Critical Conventions
[Only non-obvious, high-impact conventions]
- Convention 1 with brief explanation
- Convention 2 with brief explanation
## Known Issues / Gotchas
[Things that consistently trip up developers]
- Issue 1
- Issue 2
포함하지 말아야 할 것:
최종화 전에 확인합니다:
create 또는 기본값의 경우:update의 경우:audit의 경우:사용자가 AGENTS.md 생성/업데이트를 요청하는 경우:
AGENTS.md는 전문화된 에이전트 동작을 정의하는 데 사용됩니다. 프로젝트 컨텍스트를 위한 CLAUDE.md와 달리 AGENTS.md는 다음을 정의합니다:
유사한 원칙을 적용합니다: