반응형
반응형

claude.md 처럼 분석에 필요한 기본 .md 파일 목록

 

 

Claude Code CLI 환경에서 프로젝트를 분석하거나 개발을 진행할 때, claude.md(또는 CLAUDE.md) 외에도 함께 구성해 두면 Claude가 자동으로 조회하여 분석 품질을 극대화할 수 있는 핵심 기본 .md 파일 세트가 있습니다.

제공해주신 파일 관리 및 가이드 가이드라인에 기반하여, 프로젝트 루트 디렉토리에 구축해 두면 가장 좋은 추천 가이드라인 파일 목록과 그 안에 들어갈 핵심 내용을 정리해 드립니다.

📂 Claude CLI 분석 효율을 극대화하는 4대 기본 .md 파일 목록

1. claude.md (또는 CLAUDE.md) - 프로젝트 개발 마스터 지침서

Claude Code CLI가 실행될 때 가장 먼저 찾아서 컨텍스트에 주입하는 가장 중요한 마스터 파일입니다.

  • 핵심 포함 내용:
    • 프로젝트 실행, 빌드, 테스트, 배포를 위한 실제 터미널 명령어 명시 (npm run dev, mvn spring-boot:run 등)
    • 이 프로젝트에서 엄격하게 준수해야 하는 코딩 스타일 및 네이밍 규칙 (예: "자바스크립트는 CamelCase 준수, 변수명은 명사형으로 작성")
    • 필수 예외 처리 방식 및 프레임워크 제약 조건

2. domain.md - 비즈니스 및 도메인 용어 사전

프로젝트의 기획적 배경, 비즈니스 규칙, 그리고 데이터베이스 설계 시 사용되는 고유 도메인 용어들을 정리해 두는 파일입니다. Claude가 코드를 분석하거나 데이터베이스 사전을 만들 때 엉뚱한 기술 용어 대신 현업에서 쓰는 정확한 용어를 사용하도록 교정해 줍니다.

  • 핵심 포함 내용:
    • 용어 매핑 정의: 예) 현업 용어인 "학원"은 소스 코드와 DB에서 Academy 대신 Institute 또는 School로 통일한다.
    • 도메인 특화 규칙: 예) "회원 구분값은 1: 정회원, 2: 준회원, 3: 탈퇴회원으로 고정한다."
    • 서비스의 주요 비즈니스 도메인 범위 및 타겟층 요약

3. architecture.md (또는 system.md) - 아키텍처 및 시스템 구조 정의서

프로젝트의 전반적인 기술 스택, 폴더 구조, 데이터 흐름을 정의해 두는 파일입니다. Claude가 소스 코드를 읽기 전에 전체 지도를 먼저 파악하게 하므로, 방대한 양의 소스 코드를 분석할 때 기술적 오판을 방지해 줍니다.

  • 핵심 포함 내용:
    • 기술 스택 일람: 언어 버전(Node 18+, JDK 17 등), 프레임워크(Spring Boot 3.x, Next.js 14 등), 데이터베이스(MySQL, Redis 등)
    • 디렉토리 가이드: 주요 기능이나 모듈이 어떤 폴더 구조(app/playville, src/main/java 등) 패턴으로 설계되어 있는지 설명
    • 백엔드와 프론트엔드 간의 데이터 교환 패턴 및 외부 연동 API 시스템 목록

4. roadmap.md (또는 tasks.md) - 마일스톤 및 기술 부채 현황판

현재 프로젝트의 개발 진행 상황, 추후 개선해야 할 리팩토링 항목, 혹은 마이그레이션 타스크를 기록해 두는 파일입니다. Claude에게 다음 작업을 지시할 때 "roadmap.md에 적힌 다음 우선순위 작업을 진행해줘"라고 바로 연계할 수 있습니다.

  • 핵심 포함 내용:
    • 현재 파악된 기술 부채 및 리팩토링 대상 코드 목록
    • 기획서나 DDL 분석을 통해 도출된 추후 구현 예정 기능 일람
    • 마일스톤별 진행 상황 (Todo / In Progress / Done) 표시

💡 파일 기반 운용을 위한 Claude Code CLI 실무 팁

  1. 컨텍스트 자동 동기화: Claude Code CLI는 현재 폴더 내부의 모든 파일 상태를 실시간으로 추적합니다. VS Code 등에서 위의 .md 파일들을 수정한 뒤, 대화창에 /reset 명령어를 입력하면 이전 대화 기록을 깔끔하게 비우면서 방금 수정한 가이드 파일들의 최신 내용을 컨텍스트에 완벽하게 새로고침(Reload) 합니다.
  2. Qwen/LLM 프롬프트 파일화 활용: 만약 특정 모델(예: Qwen 등)의 스타일이나 복잡한 프롬프트 가이드를 고정적으로 쓰고 싶다면, 프로젝트 루트에 qwen_guide.md나 prompt_guide.md라는 이름으로 파일을 따로 빼두고, Claude에게 "코드 생성 시 현재 폴더의 prompt_guide.md 규칙을 준수해줘"라고 명령 파일로 사용할 수도 있습니다.
반응형
반응형

실수가 반복되면 더 이상 실수가 아니다. 그렇다고 한 번의 실수는 괜찮은가? 그것도 아니다. 단 한 번의 실수가 모든 것을 뒤 바꾸는 경우가 허다하다. 이를 테면 입사 면접에서 사소한 또는 황당한 실수가 그렇다. 아마존이 ‘아마존 채용 면접에서 절대 하지 말아야 할 6가지’를 통해 공개했다. 그만큼 이런 ‘실수’가 많다는 얘기다.

아마존 마케팅 관리자인 브리트니 번치는 아마존의 채용 담당자 6명을 직접 인터뷰해 작성한 ‘아마존 입사 지원자를 위한 면접 가이드’를 발표했다. 아마존 입사를 위해 면접을 진행하면서 지원자들이 흔히 하는 실수 또는 잘못에 대한 사례다. 하지만 적용 범위를 아마존으로 한정하지 않아도 모든 구직자가 염두에 두어야 할 중요한 내용이다.

첫째, 지각하지 말라. 수 백 수 천 번 강조해도 전혀 이상하지 않은 기본 중의 기본이다. 면접 시간에 늦게 도착하는 지각은 절대 하지 말아야 할 실수다. 만약 약속 시간에 도착할 수 있을지 장담할 수 없는 상황이라면 채용 담당자에게 가능한 빨리 지각하는 이유를 알려야 한다. 솔직하고 정확하게 상황을 설명해야 한다.

 

흔히들 지각이라고 하면 정해진 장소에 직접 가야 하는 오프라인 면접만 생각하는 데, 온라인으로 진행하는 화상 면접도 다르지 않다. 인터넷 연결 문제나 화상 면접에 사용하는 온라인 회의 도구를 미리 설치하고 준비를 마쳐야 한다. 네트워크 연결 상태를 미리 점검하고, 화상 회의 프로그램을 미리 설치하고 사용법을 익혀야 한다. 참고로 아마존은 ‘아마존 차임(Amaaon Chime)’을 활용해 온라인 면접을 진행한다.

둘째, 현재 고용주에 대한 부정적인 언행을 하지 않는다. 현재 다니고 있거나 또는 이전에 다녔던 회사의 대표나 상사에 대한 험담을 하지 말라는 의미다. 이전 직장을 그만둔 부정적인 상황이나 이유를 자세하고 장황하게 설명하는 것은 누구에게도 도움이 되지 않는다.

면접관이 알고 싶은 것은 ‘퇴사의 이유’가 아니라 지원자의 ‘업무 능력’이다. 아마존은 채용 관리자가 묻는 질문에 지원자가 정직하고 정확한 답변을 해 주기를 원한다. 과거에 직면했던 상황이나 어려움을 극복한 방법, 직무 범위, 측정된 영향력(measured impact), 고객을 대신해 어떤 서비스를 제공했는지 등 다른 측면에 더 초점을 맞춰 답변해야 한다.

 

셋째, 준비되지 않은 모습을 보이지 마라. 자신이 지원한 업무 또는 직무에 대해 정확하게 이해하고, 이를 위해 자신이 보유한 능력과 경력을 충분하게 설명할 수 있도록 준비해야 한다. 준비 없이 임하는 면접은 면접관의 질문을 제대로 이해할 수 없는 것은 물론이고, 자신이 지원한 역할에 대해 이해하지 못해 제대로 답변하지 못할 수 있다.

아마존은 “준비 부족은 사람마다 다르게 나타나며 면접 과정 전반에 걸쳐 다양한 방식으로 나타날 수 있다. 간혹 지원자가 면접에 선발될 확률을 높이기 위해 여러 직무에 지원하지만, 직무가 비슷해 보이지만 실제로는 매우 다르기 때문에 혼란을 겪고 제대로 준비하지 못하는 경우가 종종 있다”고 밝혔다.

아마존은 입사 지원자가 지원 절차를 이해하고, 전화 및 원격 면접을 준비하며, 아마존의 문화에 대해 배울 수 있도록 웹사이트(amazon.jobs)에서 여러 가이드를 제공하고 있다. 아마존의 채용 담당자는 지원자가 이러한 리소스를 활용할 것을 권장하고, 그래도 도움이 더 필요하다면 아마존 채용 지원팀에 문의할 수 있다.

 

넷째, 모호하거나 관련 없는 답변을 하지 말라. 동문서답, 횡설수설, 중언부언을 하지 말라는 뜻이다. 면접에 참여한 지원자들은 너무 긴장한 나머지 중요한 내용에 답변을 못하고 얼어붙거나, 우왕좌왕하면서 필요 없는 내용을 횡설수설하는 경우가 종종 있다. 즉, 모든 질문에 대한 답변은 간결하고 깔끔하게 한다.

아마존은 행동 기반 면접인 STAR(Situation, Task, Action, Results)를 통해 지원자 면접을 진행한다. 업무 처리 경험을 상황, 과제, 행동, 결과라는 과정을 통해 설명함으로써, 성공 또는 실패 사례와 이를 통해 성장한 방식을 간결하고 효율적으로 보여주는 것이다. 이는 아마존뿐만 아니라 다른 입사 면접에서도 지원자가 활용하면 좋은 방법이다.

다섯째, 차별적인 답변이나 질문을 하지 말라. 인종, 피부색, 종교, 국적, 나이, 성별, 장애 등 특정 요소나 집단에 대한 고정관념, 편견, 차별적 언어는 절대 피해야 한다. 욕설, 은어, 비속어 등 부적절한 단어를 사용하지 말아야 하는 것은 물론이고 편협하거나 편견을 가진 생각을 표현하는 것은 절대금물이다.

 

여섯째, 업무 관련 기밀 정보를 말하지 말라. 면접 과정에서 자신의 능력과 경력을 부각하려, 과거에 수행했거나 현재 진행 중에 업무에 대해 설명해야 할 경우가 있다. 하지만 이 경우 공개되었거나 공개해도 무방한 범위로 제한해야 한다. 아직 출시되지 않는 프로젝트나 고객과 진행 중인 계약 내용 등 업무상 중요한 기밀을 발설하는 것은 곤란하다.

이전에 근무했거나 현재 일하고 있는 직장에서의 기업 기밀을 아마존 면접에 와서 발설하지 말라는 얘기다. 재무 현황, 제품 개발, 기술 사항 등 업무상 비밀을 잘 지키는 것은 아마존이 요구하는 ‘정직성을 갖춘 리더십 원칙’에 꼭 필요한 항목 중에 하나다. 바꾸어 말하면 면접이나 입사 과정에서 이런 정보를 요구하는 기업이라면 지원자가 피해야 한다는 의미가 된다.

 

 

 

https://www.aboutamazon.com/news/workplace/amazon-job-interview-mistakes

반응형
반응형

WebSquare 2.0 Developer Guide

웹스퀘어 2.0 개발자 가이드

http://docs.inswave.com:1975/developerguide#

 

반응형

'프로그래밍 > Script' 카테고리의 다른 글

Bootstrap, it uses HTML, CSS and jQuery to make responsive web pages.  (0) 2020.06.17
javascript - toggle switch  (0) 2020.06.03
WebSquare5 간단 사용법  (0) 2020.05.21
Angular6 APP 모범 사례  (0) 2020.05.21
Node.js 모범 사례  (0) 2020.05.21

+ Recent posts