03-실전

03. 실전 — 트리 리팩터링 한 번

단계 1. 루트 파일 7개 점검

• README.md, CLAUDE.md, AGENTS.md가 모두 있는가?
• init.sh 또는 동등한 환경 셋업 스크립트?
• 진행 기록(claude-progress.txt 또는 .omc/notepad.md)?
• LICENSE, .gitignore?
• PRD 또는 최상위 의사결정 로그?

단계 2. “이름이 거짓말하는” 폴더 색출

misc, temp, archive, old, _backup, WIP, FINAL 같은 단어가 들어간 폴더는 빨간 깃발. 그 안의 내용을 열어 진짜 카테고리를 찾고 옮긴다.

단계 3. 권한 경계 명시

CLAUDE.md에 디렉터리 권한 표를 둔다.

| 경로 | 직접 쓰기 |
|---|---|
| .omc/** | OK |
| .claude/** | OK |
| wiki/** | OK (writer-pass) |
| sources/** | frontmatter만 |
| PRD/** | 사용자 승인 |

이 표가 있으면 모델이 실수로 sources/를 고치지 않는다.

단계 4. 사례·예제 다중 분류

사례 하나는 cases/by-pattern/, cases/by-role/, cases/by-tool/에 동시 등록(심볼릭 링크 또는 frontmatter 태그). 본 위키 절대 규칙 #9.

단계 5. SITEMAP.md

트리를 글로 한 번 더 표현. 새 챕터·에이전트·스킬이 추가될 때마다 갱신. 모델이 한 파일만 읽고도 전체 지도를 본다.

단계 6. 상태 폴더 분리

.omc/state/, .omc/logs/, .omc/plans/, .omc/research/ 같이 라이프사이클별로 분리. 백업·gitignore 정책도 폴더 단위로.

점검 한 줄

새로 합류한 사람(또는 에이전트)이 트리만 보고 “어디에 무엇이 있다” 를 5분 안에 말할 수 있는가? 아니라면 트리가 거짓말하고 있다.