claude.md 프롬프트 잘 작성하기

인프런 길벗 클로드코드챌린지 WEEK2 2주차를 따라가며, 팀 프로젝트에 AI를 본격 투입하는 문맥 고정 작업 설명서로 claude.md를 적용했습니다. 목적은 두 가지였습니다. 첫째, 새 멤버 합류 시에도 동일한 톤과 규칙으로 결과물을 재현하기. 둘째, 프롬프트를 짧게 써도 일관된 품질을 확보하기. 실제 과제는 React+TypeScript 인증 기능 구현이었는데, 몇 주 운용하니 추천할 만한 이유가 분명해졌습니다. 구조가 단순하고, 프로젝트 스코프와 사용자 스코프를 나눠 컨텍스트를 겹겹이 공급해 주니 로그인 폼·라우팅·토큰 관리 같은 작업 흐름이 부드러워졌습니다. 제품 전체 사진 -

프로젝트와 사용자 스코프로 맥락을 겹겹이

claude.md의 핵심은 스코프 분리였습니다. 사용자 전역 설정에는 개인 선호와 툴셋을, 프로젝트 스코프에는 팀 규칙과 기술 스택을 담아 충돌 없이 합쳐집니다. 저는 User Scope에 VS Code, Tailwind CSS, 선호 문체를 적고, Project Scope에는 React와 TypeScript, 브랜치 전략, 코드 리뷰 규칙을 정의했습니다. 2주차 과제 요구사항(이메일/비밀번호 폼, JWT 또는 외부 인증, 실패 메시지, 네비게이션 전환, 자동 로그아웃)과 스택(React Hook Form, React Query, Tailwind, Router)을 명시해 두니 브리핑을 반복할 필요가 줄었고, 같은 질문이라도 결과물의 스타일과 디렉터리 구조가 안정적으로 유지되었습니다. 확대샷 -

프롬프트 설계: 명확성, 형식, 단계적 사고

claude.md만 잘 써도 반은 먹고 들어가지만, 프롬프트는 여전히 승패를 가릅니다. 제가 효과 본 방법은 세 가지였습니다. 1 명확하고 구체적인 지시. 2 결과물 형식 지정. 3 단계별 사고 요청. 요구사항·톤·길이·대상 독자·출력 구조까지 함께 적고, XML 태그로 섹션을 나눠 컨텍스트를 공급하니 수정 횟수가 급감했습니다. 2주차에서는 토큰 매니저, 로그인 폼 유효성, React Query 훅(useLogin/useCurrentUser/useLogout), 토큰 만료 훅, AuthContext, ProtectedRoute, 페이지 구성, Tailwind 설정과 실행 방법·데모 계정까지 산출물 형식을 고정해 품질을 끌어올렸고, 이후 Firebase Auth 대체안까지 비교 서술해 학습 강도를 유지했습니다. 그 외 사진 -

주의할 점과 운영 팁, 그리고 업데이트 전략