긍정적 사고, 음식의 절제, 규칙적인 운동

Gemini에서 연결된 앱 사용 및 관리하기

https://support.google.com/gemini/answer/13695044

Claude Code CLI에서 /btw (By The Way) 명령어는 

현재 메인 작업 흐름이나 대화 기록을 오염시키지 않고, 

가벼운 단발성 질문(Side Question)을 병렬로 던질 수 있는 기능입니다.

대규모 리팩토링이나 복잡한 프로젝트 분석 같은 무거운 태스크를 

Claude에게 실행시켜 둔 상태에서 매우 유용하게 활용할 수 있는 내장(Built-in) 커맨드입니다.

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 규칙을 준수해줘"라고 명령 파일로 사용할 수도 있습니다.

CLAUDE.md

## 역할 정의
- **터미널 A (Master)**: 최종 의사결정권자. B, C, D가 제기한 질문이나 답변 후보 중 가장 적절한 것을 선택하고 승인한다.
- **터미널 B (기획/분석)**: 기획서 분석 및 요구사항 추출 담당.
- **터미널 C (프론트엔드)**: UI/UX 및 클라이언트 로직 담당.
- **터미널 D (백엔드)**: DB 구조 및 API 설계 담당.

## 프로세스 규칙
1. B, C, D는 각자 지정된 프롬프트를 실행하되, 독립적으로 최종 산출물을 쓰지 않고 중간 결과나 마스터의 판단이 필요한 질문을 `interaction_queue.md` 파일에 기록한다.
2. Master(A)는 `interaction_queue.md`를 실시간으로 모니터링하여 검토한 뒤, 최종 답변을 선택하고 승인 코드를 전달한다.

클로드 코드를 이용해 스프링 앱 개발하기 - Live 1

https://www.youtube.com/watch?v=gdg4DBcakIg

자신보다 뛰어난 사람을 채용하는 법

https://news.hada.io/topic?id=28923

• CEO가 자신이 잘 모르는 분야의 임원급 인재를 평가해야 할 때, 전문성 대신 판단할 수 있는 실질적 기준들을 제시하는 채용 가이드
• 면접 후 후보자의 아이디어를 당장 실행하고 싶은 충동이 드는지가 핵심 신호이며, 이는 문화 적합성과 맥락 이해를 동시에 검증하는 지표
• 뛰어난 리더는 자기 부서만이 아니라 조직 전체의 수준을 끌어올리는 역량을 보유해야 하며, 면접에서 이를 직접 테스트할 수 있음
• 레퍼런스 체크는 전문성이 아닌 문화 적합성 평가에 활용해야 하며, "이 사람이 최고로 빛나는 환경"과 "최악의 환경"을 묻는 방식이 효과적
• 잘못된 채용은 불가피하지만, 오판을 방치하는 것이 진짜 비용이며 즉각적인 조치가 필수

자신보다 뛰어난 사람을 채용해야 하는 이유

• 자신보다 뛰어난 사람을 채용하지 않으면 조직은 커지기만 할 뿐 나아지지 않음
• 규모가 커질수록 오버헤드, 회의, 커뮤니케이션 비용만 증가하고 개인 역량의 비례적 향상이 없음
• 뛰어난 인재는 평범한 사람보다 10배가 아니라 무한히 더 나은 존재로, 평범한 100명이 절대 떠올리지 못할 아이디어와 구현을 만들어냄
• 100명 규모에서 CEO가 여전히 어떤 영역에서든 사내 최고 역량자라면, 채용을 잘못한 것이며 회사가 피해를 보고 있는 상태
• 위임만으로는 창업자보다 나은 팀을 만들 수 없으므로, 자신이 모르는 분야의 후보를 어떻게 평가할 것인지가 핵심 과제

면접 후 그들의 아이디어를 실행하고 싶어지는가

• 면접이 끝난 뒤 "채용 여부와 관계없이 저 사람이 말한 것의 절반은 당장 해야 한다"는 생각이 드는지가 핵심 판단 기준
• 후보자의 조언이 실제로 현명한지 검증할 수는 없지만, 이 감정은 아이디어가 자사의 상황과 제약 조건에 맞닿았다는 의미
• 진정한 전문성은 해당 맥락에 맞춤형으로 느껴지는 구체적이고 실행 가능한 아이디어를 만들어냄
• 반대로, 마케팅 프레임워크에 대해 유창하게 말하면서도 5분 전 설명한 구체적 과제와 연결하지 못하는 후보자는 단순히 들은 것을 앵무새처럼 반복하는 것
  • ChatGPT도 그 정도는 할 수 있으며, 그것이 자사에 맞는지에 대한 확신은 동일하게 없음
• "이 사람이 경쟁사에 갔다면 걱정될 것인가?"라는 질문도 유효한 테스트
  • "큰일 났다"는 생각이 들면 좋은 신호, "뭘 할지 모르겠다"면 나쁜 신호

이미 그들에게서 배우고 있는가

• Zuckerberg의 유명한 채용 원칙은 "그 사람 밑에서 일할 의향이 있을 때만 채용하라"는 것
  • 문자 그대로는 맞지 않지만(Zuckerberg 본인은 다른 사람 밑에서 일한 적이 없음), 그 정신을 실제 관찰 가능한 기준으로 변환 가능
• 가장 약한 버전: 이 사람 밑에서 일하는 게 불편하다면 품질이 아닌 편의를 위해 채용하는 것
• 더 나은 버전: 이 사람에게서 배울 수 있는가, 회사의 다른 사람들도 배울 수 있는가
  • 면접 중 이미 몰랐던 것을 알게 되고, 이후 확인해보니 새로운 분야의 래빗홀에 빠진 경험이 실제 신호
• 진정한 테스트: 6개월 안식년 후 돌아왔을 때 해당 부서가 그들의 리더십 하에 측정 가능하게 더 나아져 있을 것인가
  • 프로세스 개선, 팀 강화, 산출물 향상이 그 기준

조직 전체를 끌어올리는 인재

• 훌륭한 리더는 자기 사일로만 개선하지 않음
• 인사 문제, 커뮤니케이션, 의사결정, 목표 설정, 연간 계획, 조직 구조 등 회사 전반에 유용한 역량을 보유
• 훌륭한 VP Marketing은 TypeScript 전용 CLAUDE.md에 기여할 수 없지만, 다음과 같은 영역에서 이론과 경험을 가짐
  • 3개 팀에서 30개 팀으로 성장하는 방법
  • 연간 목표를 설정하면서도 현재에 집중하게 하는 방법
  • 어려운 소식을 전사에 전달하는 방법
  • "대기업 정책"을 도입할 적절한 시점 판단
  • 이틀간의 전략 리트릿 구성 방법
  • 두 직원 간 갈등 해결 방법
  • 성과 관리를 최대한 객관적이고 인간적으로 운영하는 방법
• 면접에서 현재 직면 중이거나 곧 닥칠 것 같은 실제 상황을 제시해 이를 직접 테스트 가능

실제 문제를 풀어보게 할 것

• 회사가 실제로 겪고 있는 과제를 후보자에게 제시
  • 목표 설정에 어려움이 있다면, 목표가 없던 문화에 어떻게 도입할지 질문
  • 고객 이탈이 높다면 원인을 어떻게 진단할지 질문
  • 직원 이직률이 높다면 사람들이 말하기 꺼리는 상황에서 어떻게 파악할지 질문
• 답변의 세부 내용을 평가하는 것이 아님(평가할 역량이 없으므로), 사고 방식과 직접 경험을 관찰하는 것
  • 본질을 파고드는 명확한 질문을 하는가
  • 아직 모르는 부분을 인정하는가
  • 프레임워크를 이름만 대는 게 아니라 실제 적용 경험을 설명하는가
  • 직접 해본 것인지, 블로그 글을 그대로 따라 말하는 것인지 구분 가능

레퍼런스 체크는 문화 적합성 평가에 활용

• 일반적인 레퍼런스 체크는 전문성 평가에 무용함
  • 후보자가 좋은 말만 할 사람을 골라 제공하므로, 정제된 추천에는 가치가 없음
• 그러나 이 사람이 이 회사, 이 단계에서 잘할 것인지 평가하는 데는 강력한 도구
• 효과적인 질문 세 가지:
  • "이 사람이 최고로 빛나는 이상적 환경을 구성해 주세요" — 주제, 목표, 팀 구성, 방향성, 인센티브 등 모든 조건을 완벽하게 갖춘 상황
    • 예: "목표가 있어야 하고, 그 후엔 알아서 하게 두세요, 창의적이고 빠르게 탐색함" → "목표 지향적"이고 "탐색 욕구가 강함"이라는 속성 추출 가능
    • 이 경우 성숙한 제품보다 초기 스타트업이 적합할 수 있음
  • "이 사람이 무너지고, 모든 걸 망치고, 모두를 화나게 하는 시나리오를 구성해 주세요"
    • 묻기 재미있고 답하기 쉬우며, 부정적으로 느껴지지 않음 — 누구에게나 개인적 지옥이 있으므로
  • "본인이 인식하지 못하는 강점은 무엇인가요? 너무 자연스러워서 다른 사람도 그런 줄 아는 것"
    • 가장 자연스럽고 강력한 능력이며, 정의상 본인은 볼 수 없음
    • 가장 짜증나면서도 사랑스러운 특성이기도 함
• 약점이 없는 사람을 찾는 게 아니라, 지금 회사에 필요한 특별한 강점을 가진 사람을 찾는 것
  • 단순 역량이 아닌 초능력이 자리 채우기와 진짜 임팩트의 차이를 만듦

잘못된 채용은 불가피하지만 방치는 금물

• 면접에서 훌륭했지만 실제로 못하는 사람, 면접에서 인상적이지 않았지만 10년간 성과를 낸 사람 모두 존재
• 두 가지 오류 중 하나만 비용이 큼
  • 위음성(false negative, 좋은 사람을 놓침): 계속 탐색하면 됨
  • 위양성(false positive, 잘못된 사람을 채용): 팀에 피해, 적합한 사람 영입 지연, 본인에게도 끔찍한 상황(직장을 그만둔 경우 다음 탐색 기간도 문제)
• 잘못된 채용 후 통제할 수 있는 것은 얼마나 빨리 대응하는가
  • 1년간 방치하면 최고 인재들이 불만을 쌓고(이들은 다른 직장을 가장 쉽게 찾을 수 있음), 해당 부서 발전이 지연됨
• 직접 하는 게 더 쉽다고 느끼면 잘못 채용한 것
• 최고 인재들이 영감 대신 불평만 하고 있다면 잘못 채용한 것
• 즉각적 개선이 시작되지 않으면 잘못 채용한 것
• 팀원 모두가 이미 알고 있으며, 본인보다 더 일찍, 더 강하게 체감하고 있음
  • 그러나 이를 해결할 수 있는 사람은 오직 본인뿐이므로 깔끔하게 정리하고 즉시 행동해야 함 — 이미 3개월 늦은 상태

면접은 세부 사항이 아닌 사람 자체에 대한 것

• VP Marketing 면접에서 마케팅 역량을 평가하려 했지만, 그것은 평가할 수 없는 영역
• 1년 후에도 그들의 수요 창출 전략이 최적이었는지, 다른 사람이 매출을 더 빨리 키웠을지 반사실적 비교는 불가능
• 알 수 있는 것: 그들이 회사에 대한 시각을 바꿨는지, 몰랐던 문제를 발견했는지, 생각지 못한 것을 만들었는지, 주변 사람들을 더 날카롭게 만들었는지
• 이 단서들은 면접 중에 이미 관찰 가능했고, 문화 적합성은 레퍼런스 체크에서 확인 가능했음
• 완벽하지 않지만, 이것이 할 수 있는 최선