anti-patterns

안티패턴 — 트리가 거짓말할 때

1. misc/, temp/, old/

의미 없는 폴더 이름. 모델은 진입을 회피하거나 잘못된 가정을 한다.

2. 깊은 중첩 (5단계 이상)

모델이 Glob/ls로 도달하는 비용이 폭증. 평균 깊이 ≤ 3 권장.

3. 약속된 파일이 숨어 있음

internal/eng/notes/2026/Q2/progress.txt — 매 세션 첫 줄에 모델이 절대 못 본다.

4. 같은 사실을 여러 곳에 복제

권한 경계가 깨진다. 둘 중 어느 게 진실인지 모델이 모른다.

5. 사례를 한 분류에만 등록

본 위키 절대 금지 #11. by-pattern에만 있고 by-role에 없으면 역할별 검색이 누락한다.

6. SITEMAP 미갱신

새 챕터를 만들고 SITEMAP에 안 쓴다. 모델은 SITEMAP을 권위 있게 본다.

7. 상태 파일을 코드 안에

src/에 progress.txt. 코드 검색이 흐려지고 git diff가 더러워진다.