anti-patterns
안티패턴 — 부트스트랩
섹션 제목: “안티패턴 — 부트스트랩”- CLAUDE.md를 회사 위키처럼 사용 — 200줄을 넘기는 순간 모델 준수율이 떨어진다. 위키는 따로, CLAUDE.md는 가드레일.
/init결과를 그대로 커밋 — 자동 추정에는 거짓 양성이 섞인다. 항상 사람 리뷰 1패스.- 모순 규칙 방치 — “TypeScript strict 사용” 과 “기존 코드 스타일 유지”가 둘 다 적혀 있으면 모델은 임의로 하나를 고른다.
- 개인 선호를 프로젝트 CLAUDE.md에 적기 — 팀이 공유하는 파일이다. 개인 선호는
~/.claude/CLAUDE.md로. - 시크릿/URL을 CLAUDE.md에 적기 — 공식 권고: settings.local.json 또는 환경변수. CLAUDE.md는 git에 들어간다.
- 부트스트랩 후 한 번도 갱신하지 않음 — CLAUDE.md는 살아 있는 문서. 모델이 계속 같은 실수를 하면 그 줄을 더 구체적으로 고치는 것이 정답.