init-deep — 계층형 AGENTS.md 지식베이스 생성기

무엇을 해주나

/init-deep 명령으로 프로젝트 전체를 훑어 AGENTS.md 지식베이스를 계층적으로 만들어 줍니다.

• 1단계 탐색: 구조·진입점·컨벤션·안티패턴·빌드/CI·테스트 패턴을 담당하는 탐색 에이전트를 동시에 띄우고, 메인 세션은 bash 통계와 LSP/codegraph 심볼 맵을 수집합니다. 파일 수·라인 수·디렉터리 깊이·모노레포 여부에 따라 에이전트 수를 동적으로 늘립니다.
• 2단계 점수화: 파일 수(3배), 참조 중심도(3배), 심볼 밀도, 모듈 경계 등 가중치 매트릭스로 디렉터리를 채점해 점수 15 초과면 생성, 8~15면 도메인이 뚜렷할 때만 생성, 8 미만은 건너뜁니다.
• 3단계 생성: 루트에는 OVERVIEW·STRUCTURE·WHERE TO LOOK·CODE MAP·CONVENTIONS·ANTI-PATTERNS·COMMANDS 전체 섹션(50~150줄), 하위 디렉터리는 30~80줄 요약본을 병렬 작성합니다. 기존 파일은 Write가 아닌 Edit로만 수정합니다.
• 4단계 정리: 부모와 중복되는 내용, 모든 프로젝트에 통하는 일반론을 제거하고 분량을 다듬습니다.

--create-new(기존 문서 읽고 전부 재생성), --max-depth=N(탐색 깊이 제한) 옵션을 지원합니다.

이런 분께 추천

• 문서가 거의 없는 대형 레거시 저장소를 AI 에이전트에게 넘겨야 하는 개발자
• 패키지가 여러 개인 모노레포에서 패키지별 컨텍스트 문서를 유지하고 싶은 팀
• 신규 입사자 온보딩용 "어디를 봐야 하는지" 지도를 자동으로 만들고 싶은 테크리드
• OMO(oh-my-openagent) / Codex 멀티에이전트 환경을 이미 쓰고 있는 사용자

활용 예시

1. 처음 인수받은 5만 줄 모노레포: /init-deep 실행 → 루트 AGENTS.md와 packages/api, packages/web 등 점수가 높은 디렉터리에만 하위 문서가 생성됩니다.
2. 문서가 낡았을 때: 옵션 없이 /init-deep을 다시 돌리면 기존 AGENTS.md를 읽어 유지할 내용은 살리고 변경분만 Edit로 갱신합니다.
3. 전면 재작성: 리팩터링 후 /init-deep --create-new --max-depth=2로 기존 내용을 참고하되 2단계 깊이까지만 새로 작성합니다.

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 code-yeongyu/oh-my-openagent 의 packages/omo-codex/plugin/skills/init-deep 폴더를 내 ~/.claude/skills/init-deep/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.