optimize-claude-md
星标8
分支2
更新时间2026年7月31日 03:55
CLAUDE.md와 메모리 설정을 진단하고 개선합니다. CLAUDE.md 점검, 반복 지시 해소, 설정 최적화 요청 시 사용하세요.
安装
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
SKILL.md
readonly
下载
相关职业SOC
基于 SOC 职业分类
菜单
CLAUDE.md와 메모리 설정을 진단하고 개선합니다. CLAUDE.md 점검, 반복 지시 해소, 설정 최적화 요청 시 사용하세요.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
지정 디렉터리의 문서를 심층 분석하여 지식을 추출하고, 기존 문서 갱신 + 신규 문서 생성으로 프로젝트 지식 베이스에 반영합니다.
기술 의사결정 기록 (Architecture Decision Record). 중요한 기술적 결정의 맥락, 대안, 근거를 구조화하여 기록합니다.
현재 디렉터리의 내용을 분석하여 어떤 목적의 폴더인지 파악
슬랙/메일/메신저로 받은 업무 요청 메시지를 분석하여 의도, 핵심 내용, 판단, 액션 플랜, 대응 가이드를 정리합니다.
비즈니스 규칙, 도메인 규칙, 상태 전이 규칙을 하나의 문서로 관리합니다. 변경 이력이 누적됩니다.
열린 질문, 문제 해결, 기술 의사결정, 아이디어 발산을 구조화합니다. 회의록이나 메모 파일 경로를 인자로 전달하거나 직접 질문하세요.
| name | optimize-claude-md |
| description | CLAUDE.md와 메모리 설정을 진단하고 개선합니다. CLAUDE.md 점검, 반복 지시 해소, 설정 최적화 요청 시 사용하세요. |
| when_to_use | CLAUDE.md 진단, 지시가 안 먹힌다, 규칙이 중복인 것 같다, 설정 품질 점검. |
| argument-hint | [문제 설명 또는 공백] |
| allowed-tools | Read, Edit, Write, Agent |
| effort | high |
CLAUDE.md 및 관련 메모리 설정을 종합 분석하여 개선안을 제시하고, 승인 후 적용합니다. CLAUDE.md로 해결할 수 없는 문제는 적합한 대안(Hook, Skill, 서브에이전트, .claude/rules/)을 설명과 예시로 제안합니다.
| 데이터 | 경로 | 필수/선택 | 부재 시 동작 |
|---|---|---|---|
| 프로젝트 컨텍스트 | CLAUDE.md | 선택 | 일반 SW 가정으로 진행, [프로젝트 규칙 미확인] 태그 |
| 봇 인덱스 | bot/INDEX.md 또는 .local.claude/ONBOARDING.md | 선택 | 디렉터리 Glob 으로 fallback |
| 비즈니스 규칙 | .local.claude/biz-rules.md | 선택 | Tier 1(도메인 무관) 점검만 수행 |
| 모듈 상세 | .local.claude/modules/{name}.md | 선택 | 코드 Grep 직접 fallback |
| 대상 파일 | CLAUDE.md (프로젝트 또는 ~/.claude/) | 필수 | "대상 파일 부재" 안내 후 종료 |
| 서브에이전트 | claude-md-analyzer | 필수 | 에이전트 미설치 시 메인에서 직접 분석 fallback |
| 메모리, 훅, 규칙 | ~/.claude/memory/, settings.json hooks, rules/ | 선택 | 재배치 후보 그룹 B/C 중 Hook/Memory 옵션 제외 |
| 질문 | 담당 | 이 스킬에서 |
|---|---|---|
| "CLAUDE.md가 200줄 넘는데 어떻게 줄여?" | 이 스킬 | ✓ 핵심 (수정, 재배치, 확장 수단 제안) |
| "신규 프로젝트 CLAUDE.md 처음 생성" | /on-boarding | 다루지 않음 (생성은 on-boarding, 이 스킬은 기존 파일 개선) |
| ".local.claude/ 문서 정원, 만료, 아카이브" | /garden | 다루지 않음 (이 스킬은 CLAUDE.md와 메모리 설정에 한정) |
| "디렉터리 구조 자체를 분석" | /analyze-dir | 다루지 않음 (구조 스캔은 analyze-dir) |
$ARGUMENTS 유무에 따라 모드를 선택하세요:
[1M 활용] 서브에이전트가 부재하거나 메인에서 직접 분석 fallback 하는 경우 다중 파일 동시 Read 후 교차 분석:
- 로드: 프로젝트
CLAUDE.md,~/.claude/CLAUDE.md,~/.claude/memory/**/*.md,~/.claude/settings.json,~/.claude/settings.local.json,.claude/rules/**/*.md,~/.claude/rules/**/*.md,.claude/settings.json,.claude/settings.local.json,.mcp.json, auto memory- 교차 분석: {CLAUDE.md 규칙} vs {hooks} vs {rules/ 정책}. 중복 지시, 모순, Hook 으로 옮겨야 할 규칙, rules/ 로 분리할 도메인 지식 식별
- 200줄 초과 시 어떤 부분이 (a) 자명한 지시 (b) 도메인 지식 (c) Hook 대상 (d) rules/ 대상 인지 한 번에 분류 가능
- 한계: 총 로드 추정 토큰 ~600K(1M 컨텍스트의 60%; 줄 수로 대략 가늠) 근접 시 CLAUDE.md + 최근 변경 memory/ 만 우선 로드.
claude-md-analyzer 서브에이전트에게 분석을 위임하세요. 위임할 때 아래 정보를 전달하세요:
서브에이전트의 분석 보고서를 수신할 때까지 대기하세요.
서브에이전트가 보고한 진단 결과를 바탕으로, 발견한 문제를 아래 세 그룹으로 분류하여 개선안을 작성하세요.
각 항목에 대해:
각 항목에 대해:
각 항목에 대해:
확장 수단 선택 기준:
아래 형식으로 분석 결과를 사용자에게 보고하세요.
[파일 목록과 각 줄 수]
[각 항목의 대상 파일, 현재 내용과 수정안]
[각 항목의 현재 위치와 이동 위치]
[각 항목의 문제, 권장 수단, 예시]
보고 후 사용자에게 다음을 물으세요:
사용자가 승인한 항목만 적용하세요.
| 대상 파일 | 임계 1 (알림) | 임계 2 (강제 분리) |
|---|---|---|
CLAUDE.md (자동 로드) | 200줄 | @import / .claude/rules/ 로 분리 |
.claude/rules/{name}.md | 200줄 | 영역별 추가 분리 권장 |
CONTRACT 5절 기준. 자동 로드(@)는 핵심 파일만. detail/ref 는 @ 대상에서 제외하고 수동 참조로 전환.
.claude/rules/ 제안/biz-rules (별도 파일로 이전).local.claude/ 문서 전반 정리와 만료는 /garden/on-boarding공통 3블록(빈 / 부분 / 풀 데이터)은 CONTRACT 6-1절 참조.
[의존성 부재] claude-md-analyzer 서브에이전트 부재
.claude/agents/claude-md-analyzer* 미존재 또는 호출 실패[사용자 개입 필요] 200줄 초과 원인이 도메인 지식(biz-rules, 용어, 프로세스)일 때
biz-rules.md 등 별도 파일로 이동 여부 확인 후 진행