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

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`를 실시간으로 모니터링하여 검토한 뒤, 최종 답변을 선택하고 승인 코드를 전달한다.

책이 주는 영혼의 메시지

사람과 마찬가지로
책도 나름의 운명을 지니고 있는 것 같다.
책은 자기를 기다리는 사람에게 다가가서
딱 맞는 순간에 독자에게 나타난다. 그렇게
생명 있는 원료로 만들어진 책은
저자가 세상을 떠난 후에도
오랫동안 빛을 발한다.


- 미구엘 세라노의《헤세와 융, 영혼의 편지》중에서 -


* 명작은 작가의 사후에도
살아 움직입니다. 시간과 공간, 세대를 넘나들며
읽는 이들에게 감동을 전합니다. 한 사람의 인생에서도
같은 책이 시간에 따라 다른 의미로 받아들여지기도
합니다. 인생이 잘 풀릴 때나 잘 풀리지 않는다고
느껴질 때는 책을 읽으세요. 그 안에서 내게
딱 맞는 구절을 발견할 수 있을 것입니다.
책이 주는 영혼의 메시지입니다.

'이봐, 싱클레어,
우리의 신은 아브락사스야.
그는 신이면서 사탄이지. 그는 안에
밝은 세계와 어두운 세계를 가지고 있어.
아브락사스는 자네의 생각에도, 어떤 꿈에도
이의를 제기하지 않아. 절대로 그것을 잊지 말게.
하지만 자네가 언젠가 나무랄 데 없는 정상인이 되면
그때는 아브락사스가 자네를 떠나. 그때는 그가
자네를 떠나서 그의 사상을 담아 끓일 만한
새로운 그릇을 찾아간다네.'


- 미구엘 세라노의《헤세와 융, 영혼의 편지》중에서 -


* 우리 안에는
선과 악이 공존합니다. 천사와 악마가 공존하고,
밝은 세계와 어두운 세계도 공존합니다. 이 사실을
알 때 비로소 전인적 인간상이 완성되고, 아브락사스의
역할은 끝날 것입니다. 아브락사스는 여전히 그것을
인정하지 않는 대상을 찾아 나설 것입니다.
헤세의 '데미안'을 다시 읽는
이유입니다.

'진짜 똑똑한 행동'은 단순히 IQ가 높거나 지식을 많이 아는 것과는 다릅니다. 상황을 정확히 파악하고, 감정을 통제하며, 장기적으로 자신에게 이로운 결과를 만들어내는 '삶의 지혜와 메타인지'에 가깝습니다.

일상과 커리어에서 감탄을 자아내는 진짜 똑똑한 행동 20가지를 정리해 드립니다.

1. 자신과 타인을 대하는 태도

• "모른다"고 솔직하게 말하기: 아는 척하다가 나중에 수습하지 못하는 것보다, 모름을 인정하고 그 자리에서 빠르게 배우는 것이 훨씬 지혜롭습니다.
• 감정이 격해졌을 때 답장 미루기: 화가 나거나 당황했을 때 메일이나 메시지를 바로 보내지 않고, 최소 10분에서 다음 날 아침까지 시간을 두고 검토 후 보냅니다.
• 상대의 말을 요약하며 확인하기: "그러니까 말씀하신 내용이 ~라는 의미 맞으실까요?"라며 되묻는 행동은 오해를 줄이고 소통을 명확하게 만듭니다.
• 조언은 구하되 결정은 스스로 하기: 다양한 의견을 경청하지만, 최종 선택과 그에 대한 책임은 온전히 자신이 집니다.
• 험담에 침묵으로 대처하기: 누군가 타인의 험담을 시작할 때 동조하지 않고 자연스럽게 화제를 돌리거나 침묵함으로써 불필요한 정치 싸움에 휘말리지 않습니다.

2. 일과 생산성 관리

• 시작하기 전에 '끝'을 먼저 정의하기: 일을 시작하기 전, 이 작업의 최종 결과물이 어떤 형태여야 하는지(Definition of Done)를 먼저 명확히 하고 움직입니다.
• 가장 중요한 일(핵심)에 먼저 집중하기: 80%의 성과를 내는 20%의 핵심 작업이 무엇인지 파악하고, 에너지가 가장 넘치는 시간에 그 일을 배치합니다.
• 기록을 기억보다 신뢰하기: 아무리 사소한 아이디어나 업무 요청도 머리를 믿지 않고 메모 앱, 캘린더, 다이어리에 즉시 기록합니다.
• 문제 뒤에 숨은 '원인' 분석하기: 실수가 발생했을 때 사람을 탓하기보다 "시스템이나 프로세스의 어떤 부분이 잘못되었나?"를 먼저 찾습니다.
• 주기적으로 '하지 않을 일(Not-to-do list)' 정하기: 에너지는 한정되어 있으므로, 내 삶에서 걷어내야 할 비효율적인 습관이나 업무를 의도적으로 솎아냅니다.

3. 리스크 및 에너지 관리

• 최악의 시나리오를 미리 계산하기: 새로운 도전이나 투자를 할 때 감당할 수 있는 손실의 한계선(손절선)을 먼저 정해둡니다.
• 의존성 분산하기 (달걀을 한 바구니에 담지 않기): 소득원, 사용하는 기술 스택, 인간관계 등 삶의 중요한 축들을 한 곳에만 올인하지 않고 안전장치를 만듭니다.
• 내 에너지의 한계를 인정하고 휴식하기: 번아웃이 오기 전에 미리 일정에 휴식을 예약해 두는 과감함을 발휘합니다.
• '완벽'보다 '완료'를 추구하기: 완벽하게 만들려다 타이밍을 놓치는 것보다, 빠르게 70~80% 수준으로 완성해 공유하고 피드백을 받아 수정해 나갑니다.
• 도움 요청 타이밍 놓치지 않기: 혼자 끙끙 앓으며 시간을 낭비하기 전에, 일정 시간 고민해도 답이 안 나오면 전문가나 동료에게 명확하게 도움을 요청합니다.

4. 지속적인 성장과 메타인지

• 정기적으로 내 선택을 복기(Retrospective)하기: 한 주, 혹은 한 달 동안 내가 내린 결정과 행동 중 잘된 점과 아쉬운 점을 객관적으로 돌아봅니다.
• 나와 반대되는 의견 일부러 찾아 읽기: 내 확증 편향을 깨기 위해 나와 성향이나 가치관이 다른 사람들의 논리적인 글을 의도적으로 읽어봅니다.
• 도구를 도구답게 활용하기: AI 툴, 새로운 소프트웨어 등 생산성을 높여줄 수 있는 신기술이 나오면 거부감 없이 먼저 테스트해 보고 내 삶에 이식합니다.
• 돈으로 시간을 살 줄 아는 과감함: 내 시간당 가치보다 저렴한 비용이 드는 일(단순 반복 업무, 가사 노동 등)은 적극적으로 아웃소싱하거나 유료 서비스를 이용합니다.
• 남과의 비교를 멈추고 '어제의 나'와 비교하기: 타인의 하이라이트 릴(SNS)과 나의 비하인드 스토리를 비교하며 괴로워하지 않고, 나의 과거 데이터와 현재만 비교합니다.

이 중 지금 당장 내 삶에 적용했을 때 가장 파급력이 클 것 같은 1~2가지부터 의식적으로 실천해 보시는 것을 추천합니다.