참고링크

https://www.youtube.com/watch?v=Vj6Iohs-EDs

초기화

ClAUDE.md 작성

CLAUDE.md는 신입 온보딩 문서라고 생각하면 편하다

• Claude가 새 세션을 시작할때 가장 먼저 읽는다
• 컨텍스트 압축이 일어나도 이 파일은 그대로 사용한다

작성시 주의할점

• 사람이 직접 작성하고 AI 문장을 줄줄히 적지않기
• 길어서 핵심 파악이 힘들거나 최신화가 힘든 규칙들은 적지 않는다
• 처음부터 완성본을 만드는 것이 아니라, AI가 실패할 때 마다 한 줄씩 추가한다

작성 원칙

• 60줄 이하로 유지
• 보편적으로 항상 적용되는 내용만
• 절대 자동 생성하지 않기

예시

작업 이전

MCP 연결 관리

MCP를 연결하면 그 도구에 대한 설명이 Context에 쌓인다

• 과도한 MCP 연결은 컨텍스트 엔지니어링을 할 때 중요한 성능 저하 지점이다

작성시 주의할점

• 있는 MCP 다 연결하는거 금지
• 좋아보이는 스킬 수십 개를 전부 연결하는 것 금지

도구 설명이 많을 수록 사용자 명령을 처리할 공간이 사라진다.

MCP 팁

• MCP 대신 CLI 이용하기 : Github, Docker 등의 대부분은 CLI도 제공하므로 토큰 절약 가능
• MCP 대신 경량 도구 제작 : "Linear MCP를 버리고 필요한 기능만 모아서 작은 CLI를 직접 만들어 토큰 절약이 가능했다"
• 안쓰는 MCP 꺼두기 : 문서 작업할때는 문서 관련 MCP만 켜두자

작업 이후

세션 관리

컨텍스트 고갈 문제

• 긴 작업을 한 번에 시키면 모든 것을 한 번에 하려고 하고, 컨텍스트가 바닥나고, 절반만 구현한 채로 세션이 끝난다.
• 다음 세션이 시작되면 이전 세션에 대한 정보가 없어서 처음부터 다시 파악하는 낭비 발생

해결책

1. 세션 인수인계 문서 작성

• 작업을 마칠 때마다 지금 한 것, 어디까지 완료, 다음에 해야할 것을 기록
• 새 세션이 시작되면 기록된 인수인계를 먼저 읽기

2. feature list 작성

• 만들어야 할 기능 전부 나열
• 완료된 기능과 미완료된 기능 표시
• Json을 이용하면 임의로 ai가 수정하는 것이 줄어듬

기존 새 세션 루틴

세션 컨텍스트 사용률 이상치

• 40% 초과 한다면 작업단위가 너무 크거나 불필요한 정보가 너무 많으므로 더 작게 작업 나누기
• 자동 컴팩션 작동하기 전에 /fork 이용해서 지금까지 쌓인 컨텍스트로 새 세션에서 그대로 수행
  • 새 세션에서 작업이 끝나면 작업 결과물만 메인 세션으로 가져간다

작업 핵심 파이프라인

정리

1. 세션간 인수인계 구조 제작
2. 기능 목록 관리
3. 컨텍스트 40% 기준으로 작업 단위 쪼개기
4. /fork로 메인 세션 보존하기
5. 작업 하나 끝날 때마다 커밋 + 진행 파일 업데이트