★★★★★

#출시·운영·디버그 · claude-code

새 함정 발견 시 글로벌 메모리 추가 형식

개발 중 새로운 함정을 발견했을 때(예: iOS 26 Swift Concurrency 버그, Firestore doc ID 불일치 등), 글로벌 메모리에 추가해서 향후에 같은 실수를 반복하지 않으려고 해.

#documentation#memory#pitfalls#best-practices

변수 3개 — 여기 채우면 아래 프롬프트에 바로 들어가요

{{증상이뭔가}}

{{구체적인원인}}

{{정확한해결책}}

개발 중 새로운 함정을 발견했을 때(예: iOS 26 Swift Concurrency 버그, Firestore doc ID 불일치 등), 글로벌 메모리에 추가해서 향후에 같은 실수를 반복하지 않으려고 해. 글로벌 CLAUDE.md의 "반복 실수 방지 체크리스트" 섹션에 추가하는 형식: ``` | # | 증상 | 원인 | 해결 | |---|------|------|------| | N | {{증상이뭔가}} | {{구체적인원인}} | {{정확한해결책}} | ``` 예시(이미 추가됨): - #3: Apple 로그인 진입 안 됨 → CODE_SIGN_ENTITLEMENTS 누락 - #12: 로컬 알림 시간 틀림 → tz.setLocalLocation() 미호출 - #18: Transporter 버전 에러 → pubspec.yaml version 형식 새로운 함정을 추가할 때: 1. 증상: 겉으로 드러나는 에러 메시지 (에러 코드 포함) 2. 원인: 왜 이 증상이 나타났는가 (code path) 3. 해결: 정확한 fix (라인 번호 지시 X, 일반적인 방법) 또한: - 특정 프로젝트에만 해당하면 프로젝트 CLAUDE.md에 먼저 추가 - 재현 가능한 단계 추가 (복잡한 경우) - 참조 docs 파일 명시 어떤 함정이 글로벌에 추가할 만한 중요도인지 판단하는 기준까지 설명해줄래?

쓰는 법 — 위 칸에 본인 값을 채우면 아래 프롬프트에 바로 반영돼요. 복사 버튼을 누르면 채워진 그대로 클립보드에 담기니까, claude-code(또는 본인이 쓰는 AI)에 붙여넣기만 하면 됩니다. 변수가 없으면 그냥 복사해서 쓰세요.