
당신의 CLAUDE. md는 아마도 잘못되었을 것입니다.
요약
본 문서는 Claude에게 효과적으로 지시하는 방법을 안내하며, 일반적인 'CLAUDE.md' 방식의 오류를 지적합니다. 대신 명령어(Commands), 아키텍처(Architecture), 규칙(Rules), 규모+메모리(Scale + Memory) 네 가지 섹션을 활용하여 명확하고 구조화된 프롬프트를 작성하는 것이 중요하다고 강조합니다.
핵심 포인트
- Claude는 모호한 단락이나 추측성 지시를 잘못 해석할 수 있습니다.
- 명령어, 아키텍처, 규칙, 메모리 등 4가지 섹션으로 내용을 분리해야 합니다.
- 규칙은 검증 가능하고 구체적이어야 하며, 같은 실수는 새로운 규칙으로 정의하세요.
- 불필요한 내용은 제거하고, 핵심적인 실행(must-runs)보다는 훅(Hooks)을 사용하는 것이 좋습니다.
당신의 CLAUDE. md는 아마도 잘못되었을 것입니다.
제가 아는 방법은 다음과 같습니다:
만약 단락이 있다면, 그것은 잘못된 것입니다.
'시니어 엔지니어가 되라'고 말한다면, 잘못된 것입니다.
만약 스스로 모순된다면, 확실히 잘못된 것입니다.
4가지 섹션이 모든 것을 해결합니다:
𝟭. 𝗖𝗼𝗺𝗺𝗮𝗻𝗱𝘀 (명령어)
Claude가 스스로 추측할 수 없는 것들입니다.
↳ 테스트: 정확한 명령어, 정확한 플래그
↳ 빌드 + 실행: 각각 한 줄로
↳ 커밋 전 항상 린트(Lint)하기
↳ 모두가 잊는 환경 변수 특이점 (Env quirks)
↳ /init은 이것들을 초안으로 작성해줍니다.
𝟮. 𝗔𝗿𝗰𝗵𝗶𝘁𝗲𝗰𝘁𝘂𝗿𝗲 (아키텍처)
코드베이스에서 것들이 어디에 존재하는지입니다.
↳ 개념이 아닌 폴더를 매핑하세요.
↳ 블록을 붙여넣기 말고 경로를 지정하세요.
↳ 백틱(``)은 문자 그대로의 텍스트를 의미합니다.
↳ 이름 패턴: '컨트롤러가 아닌 서비스'처럼요.
↳ 임포트(imports)는 최대 4단계까지만 허용합니다.
𝟯. 𝗥𝘂𝗹𝗲𝘀 (규칙)
검증할 수 있는 것을 작성하세요.
↳ '2칸 들여쓰기' = 좋음
↳ '깨끗한 코드를 작성하라' = 쓸모없음
↳ 200줄 미만이거나 준수하지 않으면 효력이 떨어집니다.
↳ 같은 실수를 두 번 했다면 = 새로운 규칙으로 만드세요.
↳ 린터(linter)의 중복은 완전히 건너뛰세요.
𝟰. 𝗦𝗰𝗮𝗹𝗲 + 𝗠𝗲𝗺𝗼𝗿𝘆 (규모 + 메모리)
적게 로드하고, 더 많이 기억하세요.
↳ .claude/rules/는 경로 일치로 로드됩니다.
↳ 불필요하거나 오래된 규칙은 잘못된 경로를 유도합니다.
↳ 필수 실행(must-runs)에 대한 희망보다는 훅(Hooks)이 좋습니다.
↳ 자동 메모리: 200줄, 자동으로 로드됩니다.
↳ /memory는 혼란을 정리해줍니다.
한 규칙당 한 줄. 단락 금지. 페르소나 금지. 모순 금지.
Claude는 당신이 쓰는 것을 정확히 읽습니다.
그러니 당신이 의미하는 바를 정확하게 쓰세요.
Muhammad Ayan을 팔로우하세요 ♻️ 다른 사람들을 돕기 위해 리포스트(Repost)하세요
AI 자동 생성 콘텐츠
본 콘텐츠는 X @socialwithaayan (자동 발견)의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기