CLAUDE.md 외에 어떤 파일들을 관리하시나요?

wtf.md

Claude가 했던 이상하고 잘못된 행동들, 다시는 하지 말아야 할 것들

프로젝트마다 하나씩 만드시나요, 아니면 전역으로 하나 만들어서 설정하시나요?

실수가 다른 코드베이스에서도 반복될지 여부에 따라 나누는 게 좋음. '스키마는 null을 허용하는데 필드가 필수라고 가정함' 같은 건 프로젝트 잡지식이라 이 레포 스키마 안에서만 의미가 있으니 프로젝트별 파일에 넣으면 됨. '요청하지도 않은 인접 코드를 수정함'이나 '실행도 안 해보고 완료 처리함' 같은 건 이 프로젝트랑은 상관없는 문제고, 스택 상관없이 나타나는 패턴임. 이건 전역으로 관리해서 한 번만 작성해두면 모든 프로젝트에서 공짜로 가져다 쓰면 됨. ...에 두기보다는 분리해서 관리할 가치가 있음.

저는 의사결정과 실수를 분리해서 관리해요. 한 파일에는 아키텍처 선택, 트레이드오프, 날짜를 기록하고, 다른 하나는 일회성 세션 상태(변경 사항, 차단된 작업, 다음에 실행할 명령어)를 기록하죠.

이렇게 분리하는 게 중요한 이유는 모든 실패를 영구적인 지침으로 만들면 프로젝트 컨텍스트가 방어적인 규칙들로 가득 차버리기 때문이에요. 두 파일 모두 용량을 제한하고 더 이상 변경되지 않는 오래된 항목은 압축해요. 안 그러면 Claude가 다음 행동을 결정하는 대신 프로젝트 기록에 컨텍스트를 다 써버리거든요.

저도 한동안 비슷한 방식을 써왔는데, 프로젝트마다 스택(Flutter, React 등)이 달라서 파일을 더 많이 쪼개서 사용 중이에요.

핵심 프로토콜: - AGENTS.md — 실제 규칙집: 4단계 주기(인지 → 추론 및 계획 → 실행 → 개선), 그리고 '데이터가 부족하다고 지어내지 말고 오류 상태를 보여줄 것' 같은 절대 타협 불가 규칙, 그리고 작업 완료 표시 전 기능 검증 요구 사항(단순히 '테스트 통과'가 아니라 실제 증거가 필요함)