M4 - 코드베이스 이해와 기여 — Claude Code로 기존 프로젝트에 뛰어들고 안전하게 코드 수정하기

요약

핵심 포인트

• 코드베이스를 보호하기 위해 '룰즈'로 코딩 패턴을 유도하고, '디나이' 권한으로 물리적으로 접근이 금지된 영역(레거시 코드 등)을 도구 단에서 차단하는 이중 가드레일을 설정해야 합니다. 0:52
• 슬래시 이니셜라이즈 명령어로 코드베이스의 기본 구조를 파악하고, 개발자만이 아는 맥락(레거시 수정 금지 등)을 클로드.md 파일에 기록하여 팀 전체의 지식 기반을 구축해야 합니다. 4:15
• 클로드 코드를 사용할 때 가장 중요한 원칙은 탐색과 구현을 분리하고, 중간에 슬래시 클리어로 컨텍스트를 정리하여 결과물의 품질을 유지하는 것입니다. 5:24
• 코드를 탐색할 때는 진입점, 수정 대상 영역, 데이터 흐름 순서로 접근하되, 비즈니스 로직이 코드 외부의 DB나 설정 파일에 숨어 있을 수 있음을 항상 의심해야 합니다. 7:55
• 서브에이전트를 활용하여 코드 탐색을 격리된 공간에서 수행함으로써 메인 컨텍스트의 오염을 방지하고, 결론과 파일 경로만 메인 세션으로 회수하는 것이 효율적입니다. 9:16
• 워크플로우나 에이전트를 통해 얻은 분석 결과는 반드시 실제 코드와 대조하여 검증해야 하며, 이는 할루시네이션을 방지하고 신뢰할 수 있는 결과를 도출하는 필수 단계입니다. 10:16
• 다수의 서비스를 동시에 분석해야 할 때는 다이내믹 워크플로우를 사용하여 병렬 처리를 하고, 중간 결과는 스크립트 변수에 저장한 뒤 최종 합성된 결론만 메인에 전달해야 합니다. 21:59
• 클로드.md 파일은 전체적인 지도 역할을 하므로 200줄 이내로 짧게 유지하고, 서비스별 상세 규칙은 각 폴더의 전용 클로드.md 파일로 분리하여 필요할 때만 로드하도록 구성해야 합니다. 23:56
• 새로운 기능을 구현할 때는 코드 작성 전에 스펙 문서를 먼저 작성하고, 플랜 모드로 계획을 승인받은 후 기존 코드 패턴을 참조하여 구현하는 것이 안전합니다. 28:12
• LSP(언어 서버 프로토콜)를 활용하여 코드 참조를 심볼 단위로 정확히 추적하고, 사용하지 않는 언어의 플러그인은 비활성화하여 불필요한 토큰 소모를 줄이는 것이 좋습니다. 31:26