팀 스터디 · Claude Code

Claude Code를 오래 쓰면
생기는 네 가지 문제

쓰다가 실제로 부딪힌 것들, 그리고 각각에 붙여본 해법 하나씩.

sori · 2026-07 ← 스터디 페이지로
먼저 물어볼 것

다들 이거 겪지 않으세요?

01 지식이 휘발된다 세션 끝 = 통찰 소멸
02 기록이 흩어진다 어디서 얘기했더라
03 같은 내용을 세 군데 적는다 바뀔 때마다 세 군데 수정
04 내 지시가 좋은지 모른다 피드백 루프 부재

해법은 뒤에서. 지금은 문제가 공감되는지만 봅니다.

문제 01 · 지식 휘발
01

사람이 게이트키퍼로 선다

세션이 끝나면 대화에서 나온 통찰이 사라집니다. 해법은 제안 후 승인 패턴 — 클로드가 저장할 만한 내용을 제안하고, 사람이 큐레이터로서 승인해야 ~/claude/knowledge/wiki/에 들어갑니다.

READ 명시적 요청이 있을 때만 자동으로 위키를 열지 않는다. 토큰을 지킨다.
SAVE 제안이 먼저, 승인이 나중 위키가 잡동사니가 되는 걸 막는다.

두 규칙은 불변. 예외를 두는 순간 둘 다 무너집니다.

문제 02 · 기록 분산
02

위치가 곧 컨텍스트다

원칙

대화 주제가 사는 폴더에서 클로드를 켠다.

~/.claude/ └── CLAUDE.md ← 항상 로드 · 내 전역 규칙 ~/claude/ops/mattermost/ 여기서 `claude` 실행 ├── CLAUDE.md ← 자동 로드 · 이 방의 규칙 ├── WORK-LOG.md ← 지난 대화가 남긴 상태 └── values.yaml

켜는 순간 위 두 CLAUDE.md가 위에서 아래로 얹힙니다. "우리 Mattermost 설정이 뭐였지"를 설명할 필요가 없어져요 — 어디서 켜느냐가 이미 절반의 프롬프트입니다.

문제 03 · 이중 기록
03

리트머스 시험지 하나로 거른다

제품 이름을 빼도 제목이 말이 되는가?
예 → 개념 개인 볼트로. 그 제품 밖에서도 재사용되는 지식이다.
아니오 → 사정 제품 레포의 docs·ADR·작업 로그로. 그 제품에서만 참인 얘기다.

종류마다 주인 자리 하나, 나머지엔 포인터 한 줄. 그래야 고칠 때 한 군데만 고칩니다.

문제 04 · 프롬프트 피드백
04

지시문 자체를 측정한다

매일 새벽 크론이 history.jsonl에서 어제의 프롬프트를 뽑아 리뷰하고, 아침 첫 세션에 "오늘의 강한 단어" 리포트를 넣어줍니다. 약한 표현을 짚어주고 검증된 도메인 용어를 추천해요.

핵심 관점

영향력 있는 언어는 새로 지어낸 개념이 아니라 확립된 실천에서 나온다.

DDD · 리팩터링 · 실용주의 프로그래머의 어휘가 통하는 이유.

저는 여기까지 갔는데, 이건 좀 과합니다
오늘 바로 써먹을 것

질문 두 개면 충분합니다

삭제 테스트 · 스킬/규칙 설계 그 문단 없이 다시 써봐라. 에이전트 행동이 달라지나? 아니라면 애초에 필요 없던 문단입니다. CLAUDE.md가 길어질 때마다 돌려보세요.
리트머스 · 이중 기록 방지 제품 이름을 빼도 제목이 말이 되나? 개념이면 볼트, 사정이면 제품 문서. 저장 직전 3초면 판정됩니다.
참고 · 작업공간 계층

대화, 운영, 지식을 섞지 않는다

~/claude/ ├── temp/ # 임시 대화 — 남기지 않을 것 (기본값) ├── ops/ # 운영 논의 — 결정과 그 근거 └── knowledge/ # 지식 볼트 — 제품 이름 없이 참인 것 └── wiki/ ~/projects/ └── <product>/ # 실제 저장소 — docs · ADR · WORK-LOG

계층이 다르면 수명이 다릅니다. 수명이 다른 걸 한 폴더에 두면 결국 전부 temp가 됩니다.

한 줄로 줄이면

에이전트가 아니라 사람이 지식의 게이트키퍼를 맡고, 위치가 곧 컨텍스트이며, 지시문 자체를 측정 대상으로 삼는다.

위키도 크론도 제 사례일 뿐입니다. 가져가실 건 도구가 아니라 질문 두 개 — 삭제 테스트와 리트머스.

질문 · 반론 환영 위키 통째로 읽어보기 →