Claude Code 인사이트

66개 세션(총 171개) 동안 1,111개 메시지 | 2026-01-13 ~ 2026-02-18

한눈에 보기
잘 되고 있는 점: Godot 우주 게임, 한국어 웹 앱, 실시간 암호화폐 트레이딩 봇 등 다양한 프로젝트에서 Claude를 빠른 배포 파트너로 효과적으로 활용하고 있으며, 매 세션마다 기능을 커밋하고 배포하고 있습니다. 반복적 피드백 스타일이 강점입니다. 뛰어난 시각적 감각으로 결과물이 마음에 들지 않으면 단호하게 수정을 요구하며, 몇 번의 반복을 거쳐도 결국 깔끔한 결과물을 만들어냅니다. 인상적인 성과 보기 →
개선이 필요한 점: Claude 측에서는 실제 원인을 찾기 전에 잘못된 수정 가설을 여러 번 시도하는 경우가 많고, 세션 중간에 폐기해야 하는 초기 아키텍처나 기술 스택을 선택하기도 합니다(Tauri에서 Python으로 전환, 편광 기능 오해 등). 사용자 측에서는 레이아웃/UI 작업이 초기 요청에 공간적 세부사항 해석의 여지가 있어 3~5회 수정 반복으로 이어지는 경우가 많습니다. 또한 버그에 대한 진단 감이 있을 때 더 일찍 공유하면 불필요한 디버깅 시간을 크게 줄일 수 있습니다. 문제가 발생하는 곳 보기 →
바로 시도할 수 있는 것: Task Agent를 사용해 탐색을 병렬화해 보세요. 예를 들어 스택 옵션을 평가하거나 까다로운 문제를 디버깅할 때, 순차적으로 진행하는 대신 Claude가 서브 에이전트를 생성해 다른 가설을 동시에 조사하도록 할 수 있습니다. 또한 "커밋, 푸시, GitHub 릴리스 생성"이나 "백테스트 실행 후 결과 요약" 같은 반복 워크플로우를 커스텀 스킬(마크다운 프롬프트 파일)로 만들어 단일 `/command`로 실행할 수 있습니다. 추천 기능 보기 →
향후 워크플로우: 모델이 더 발전하면, 각각 다른 가설을 테스트하는 병렬 버그 수정 에이전트를 실행하고 빌드를 통과한 결과만 표시할 수 있게 됩니다. 이렇게 하면 고통스러운 5회 이상의 디버깅 반복을 완전히 제거할 수 있습니다. 멀티 파일 변경 세션도 한 단계 발전할 것입니다. Claude가 샌드박스 브랜치에서 대규모 리팩터링을 실행하고, 전체 테스트 스위트를 돌린 후, 깔끔한 diff만 승인용으로 제시하는 것을 상상해 보세요. "거의 완료" 세션이 중간 피벗 없이 완전히 배포된 세션으로 바뀝니다. 미래 전망 보기 →
1,111
메시지
+86,552/-6,014
라인
826
파일
25
일
44.4
일평균 메시지

작업 프로젝트

한국어 단체 주문 & 투표 웹 앱 약 12 세션
커피/단체 주문 앱(콧퐁)과 투표 플랫폼을 포함한 한국어 웹 애플리케이션 개발. 익명 사용자 접근, 그룹 페이지 기능, 즐겨찾기, SNS 스타일 리디자인, MBTI 성격 분석, PWA 관리, 인앱 브라우저 감지, 반복적 UI 개선 등을 다룸. Claude Code가 빠른 기능 반복 사이클 전반에 걸쳐 멀티 파일 TypeScript/Next.js 변경, git 작업, 배포 워크플로우를 처리함.
Godot 우주 게임 (Stellar Pioneer) 약 10 세션
Godot 기반 우주 탐험 게임의 지속적 개발. 경제 밸런싱, 함선 슬롯/수익화 설계, 천문대 시스템을 통한 별 발견, IAP/상점 UI, 발사 장면 수정(로켓 위치, 카메라 흔들림 버그), Gaia 데이터 통합 기획, 밝기 조정 및 발사대 비주얼 등 시각적 개선 포함. Claude Code는 반복적 게임 로직 수정, 씬 디버깅, 게임 디자인 문서 검토, 광고 수익화 등 향후 기능 기획에 활용됨.
ComfyUI RAW 이미지 처리 노드 약 8 세션
RAW 이미지 처리를 위한 커스텀 ComfyUI 노드 개발. 패턴 채널 추출, 수학 연산, 크롭/플립, 배치 로딩, 통계, 스팟 찾기, Bayer 패턴 분리 포함. Claude Code가 노드 파일 구현, 테스트 실행, 서버 재시작, git 작업 관리를 수행함. 드래그 앤 드롭, 자동 적용 설정, 플랫폼 스타일링을 갖춘 CrossMetrology 측정 도구 개발과 깨진 UI 상호작용 수정도 포함됨.
암호화폐 트레이딩 봇 & 전략 개발 약 7 세션
실시간 암호화폐 차익거래 및 스캘핑 트레이딩 시스템 개발. 시그널 필터링, 거부 로깅, 전략 개선(SL/TP, 추세 필터, 쿨다운), 벡터화를 통한 약 500배 속도 향상의 병렬 백테스팅, 결과 시각화 대시보드 포함. Claude Code가 멀티 파일 전략 변경, 백테스트 실행, 설정 정리를 수행하고, Next.js 웹 대시보드가 포함된 자동 트레이딩 봇 아키텍처 설계를 지원함.
광학 시뮬레이션 문서 & 대시보드 도구 약 8 세션
광학 시뮬레이터용 VitePress 문서 사이트(도 기호, 편광 옵션, 사이드바 재구성, Macbeth ColorChecker), 스펙트럼 차트와 CIE 다이어그램이 포함된 풀스크린 대시보드 레이아웃, Remotion 비디오 프로젝트와 Gemini API 통합이 포함된 AXEL 개선 프로젝트 등 보조 도구 작업. Claude Code가 반복적 레이아웃 개선, 접근성 수정, 멀티 파일 편집, 자동 스크린샷 촬영, ads.txt 검증 등 배포 관련 작업을 수행함.
요청 목표
Git 작업
34
버그 수정
27
기능 구현
27
UI 레이아웃 변경
6
Git 푸시
5
버그 수정
5
가장 많이 사용한 도구
Edit
1479
Bash
1451
Read
1404
Write
543
Grep
428
Glob
139
프로그래밍 언어
TypeScript
1344
Python
379
Markdown
279
HTML
196
JavaScript
112
JSON
66
세션 유형
다중 작업
25
반복 개선
17
단일 작업
7
간단한 질문
1

Claude Code 사용 패턴

당신은 다작의 멀티 프로젝트 파워 유저로, Godot 우주 게임, ComfyUI 노드 개발, 한국어 투표 플랫폼, 암호화폐 트레이딩 봇, 광학 시뮬레이션 도구 등 인상적으로 넓은 범위의 작업에서 Claude Code를 거의 상시적인 개발 동반자로 활용하고 있습니다. 66개 세션과 287개 커밋을 5주 남짓한 기간에 걸쳐, 빠른 속도의 반복 개선 스타일을 유지합니다: Claude에게 작업을 주고, 결과를 빠르게 검토한 후, 즉시 방향을 수정하거나 다음 요청을 쌓아 올립니다. 상세한 사전 명세를 거의 작성하지 않고, 대신 결과를 보고 반응하는 방식을 선호합니다. 이로 인해 세션에는 종종 여러 차례의 조정이 수반됩니다. 예를 들어, Claude의 차트 배치와 크기 선택이 반복적으로 비전과 맞지 않았던 풀스크린 대시보드 레이아웃이나, 20px 미세 조정이 두 번 필요했던 UFO 위치 작업 등이 그렇습니다. Claude가 잘못된 방향으로 갈 때 빠르게 개입하거나 되돌립니다(예: 발사대에서 스윙 암 즉시 제거, 너무 작게 만들어진 통계 섹션 되돌리기).

당신의 상호작용 패턴은 적극적으로 위임하고 Claude가 멀티 파일 변경을 처리하도록 신뢰하는 사용자의 모습을 보여줍니다. 상위 성공 패턴(36건의 멀티 파일 변경)과 Edit(1,479회), Bash(1,451회), Read(1,404회) 도구의 집중적 사용이 이를 확인해 줍니다. 하나의 세션 내에서 작업을 연쇄적으로 진행하는 경우가 많습니다: 버그를 고치고, git에 푸시하고, 다음 기능을 기획하고, 구현을 시작합니다. Git 작업이 가장 흔한 목표 카테고리(34개 세션)인 것은 Claude를 코딩뿐 아니라 엔드 투 엔드 배포 파이프라인으로 사용하고 있음을 시사합니다. 코드 작성, 테스트 실행, 커밋, 푸시, GitHub 릴리스 생성까지 모두 포함합니다. 마찰이 발생할 때, 가장 흔한 원인은 요청을 오해한 것이 아니라 Claude가 잘못된 접근 방식(19건)을 취한 것입니다. 이는 간결하고 반응적인 프롬프팅 스타일을 고려하면 자연스럽습니다. 특히, Claude가 5회 이상 잘못된 클릭 수정을 시도했을 때 직접 나서서 브라우저 스토리지가 근본 원인임을 밝혀낸 것은 기술적으로 예리하며, Claude가 헤매고 있을 때 주저 없이 개입하는 모습을 보여줍니다.

TypeScript(주력), Python, HTML, Markdown, JavaScript를 사용하며, 가끔 Rust, Java, CSS도 다룹니다. 이는 단일 코드베이스가 아닌 진정으로 다양한 프로젝트 유형을 반영합니다. 만족도는 매우 긍정적으로 편향되어 있으며(만족 추정 150 vs 불만족 21), 결과는 "거의 달성"(25건)에 집중됩니다. 이는 세션을 야심차게 밀어붙여, 깨끗한 경계에서 멈추기보다 계획이나 구현 중간에 끝나는 경우가 많은 사용자의 특징입니다. Claude Code를 신중한 컨설턴트가 아니라 실시간으로 페어 프로그래밍하는 빠른 주니어 개발자처럼 다루며, 긴 브리핑보다 빠른 수정으로 방향을 조종합니다.

핵심 패턴: 적극적으로 위임하고, Claude의 git 파이프라인을 통해 배포하며, 상세한 명세 대신 결과물에 반응하면서 방향을 조종하는, 빠른 반복의 멀티 프로젝트 파워 유저입니다.
사용자 응답 시간 분포
2-10초
28
10-30초
85
30초-1분
142
1-2분
170
2-5분
229
5-15분
181
>15분
90
중앙값: 137.5초 • 평균: 346.5초
멀티 클로딩 (병렬 세션)
48
중첩 이벤트
49
관련 세션
30%
전체 메시지 비율

여러 Claude Code 세션을 동시에 실행하고 있습니다. 멀티 클로딩은 세션이 시간상 중첩될 때 감지되며, 병렬 워크플로우를 의미합니다.

시간대별 사용자 메시지
오전 (6-12)
185
오후 (12-18)
154
저녁 (18-24)
654
심야 (0-6)
118
도구 오류 현황
명령 실패
100
기타
51
사용자 거부
13
편집 실패
7
파일 너무 큼
6
파일 없음
6

인상적인 성과

지난 한 달간 게임 개발, 트레이딩 봇, 웹 앱, 이미지 처리 도구 등 66개 세션에 걸쳐 매우 활발한 Claude Code 사용자였으며, 실제 기능을 배포하고 코드를 푸시한 견고한 실적을 보유하고 있습니다.

빠른 멀티 프로젝트 풀스택 배포
Godot 우주 게임, 한국어 투표/SNS 플랫폼, 암호화폐 차익거래 봇, ComfyUI 이미지 처리 노드 등 인상적으로 넓은 범위의 프로젝트를 동시에 진행하면서, 매 세션마다 기능을 일관되게 커밋하고 푸시하고 있습니다. 66개 세션에서 287개 커밋으로 세션당 평균 4개 이상의 커밋을 달성하며, Claude를 지속적 배포를 위한 진정한 페어 프로그래밍 파트너로 활용하고 있습니다.
명확한 방향성을 가진 반복적 UI 개선
뛰어난 시각적 감각을 가지고 있으며, 대시보드 레이아웃, 게임 UI 폴리싱, SNS 스타일 앱 리디자인 등에서 Claude의 레이아웃이나 디자인 선택이 비전과 맞지 않을 때 주저 없이 수정을 요구합니다. 무엇이 잘못됐고 무엇을 원하는지 명확하게 전달하는 이 반복적 피드백 루프는 CrossMetrology 도구, VibePulse 페이지, 풀스크린 대시보드 작업에서 볼 수 있듯이 일관되게 깔끔한 결과물을 만들어냅니다.
복잡한 구현 전 전략적 기획
트레이딩 전략 개선 계획, 게임 경제 밸런싱부터 대규모 리팩터링과 기능 로드맵까지, 코드에 뛰어들기 전에 정기적으로 Claude를 활용해 코드베이스를 탐색하고, 상세한 계획 문서를 작성하고, 시스템을 설계합니다. TodoWrite(92회)와 TaskUpdate(83회) 사용은 즉흥적 코딩이 아닌 구조화된 작업 관리를 활용해 복잡한 멀티 파일 구현을 체계적으로 진행하고 있음을 보여줍니다.
가장 도움이 된 것 (Claude 역량)
멀티 파일 변경
36
디버깅 성공
5
정확한 코드 편집
4
선제적 도움
3
좋은 설명
1
결과
미달성
1
부분 달성
9
거의 달성
25
완전 달성
14
불명확
1

문제가 발생하는 곳

세션에서 Claude의 초기 구현이 빗나가 여러 차례 수정이 필요한 경우가 빈번하며, 특히 시각적/UI 작업, 디버깅 근본 원인 파악, 아키텍처 결정에서 주로 발생합니다.

불충분한 요구사항으로 인한 반복적 UI/레이아웃 수정
Claude의 시각적/레이아웃 선택이 비전과 맞지 않아 여러 차례 수정 반복이 발생하는 경우가 많습니다. 와이어프레임, 참조 스크린샷, 또는 더 정확한 명세(예: 정확한 픽셀값, 컴포넌트 계층, 목업 설명)를 사전에 제공하면 이러한 수정 루프를 크게 줄일 수 있습니다.
  • 풀스크린 대시보드 레이아웃은 Claude가 잘못된 그리드 단위로 차트를 나란히 배치해 여러 차례 수정이 필요했습니다. 정확한 배치와 비율을 사전에 설명했다면 여러 번의 반복을 절약할 수 있었습니다.
  • CrossMetrology 도구, 밝기 조정, UFO 위치 지정, 통계 섹션 크기 등 모두 2회 이상의 조정이 필요했으며, Claude의 첫 번째 추측이 의도와 맞지 않는 패턴을 보여 시각적 기대치 전달이 부족했음을 시사합니다.
잘못된 근본 원인 진단으로 인한 디버깅 시간 낭비
버그를 만났을 때, Claude는 실제 원인을 찾기 전에 잘못된 가설을 여러 번 시도하는 경우가 많습니다. 특히 근본 문제가 환경적이거나 비자명적일 때 그렇습니다. 자체적인 진단 추측을 더 일찍 공유하거나 환경 컨텍스트를 더 제공하면 시간을 절약할 수 있습니다. 브라우저 스토리지 문제에서처럼 이미 답을 알고 있는 경우도 있기 때문입니다.
  • Claude는 깨진 UI 클릭에 대해 5회 이상 잘못된 수정을 시도했습니다(라우트 변경, 로케일 파일, 프론트엔드 다운그레이드). 그러나 사용자가 브라우저 스토리지가 근본 원인임을 직접 밝혔습니다. 직감을 더 일찍 공유했다면 상당한 시간을 절약할 수 있었습니다.
  • 로켓 위치 버그는 처음에 잘못된 Y좌표 수정을 거친 후에야 Claude가 실제 문제는 흔들림 코드가 X/Z를 원점으로 리셋하는 것임을 발견했습니다. 이는 심층 조사 전에 표면적 수정을 하는 패턴을 보여줍니다.
성급하거나 잘못된 아키텍처 접근으로 인한 방향 전환
Claude가 선택한 초기 기술적 접근이나 아키텍처가 실패해 세션 중간에 비용이 큰 방향 전환이 필요한 경우가 여러 번 있었습니다. 인프라나 스택 결정이 필요한 프로젝트를 시작할 때, 코드 작성 전에 Claude에게 트레이드오프와 제약 조건(무료 티어 한도, 빌드 도구 요구사항, SDK 호환성)을 평가하도록 요청하면 이러한 막다른 길을 방지할 수 있습니다.
  • 풀스택 테스트 플랫폼이 무료 티어 한도와 호환성 문제로 세 번의 플랫폼 전환(Supabase → Cloudflare → Vercel/Turso)을 거쳤고, 여전히 OAuth 오류에서 막혔습니다. 사전 제약 조건 분석으로 이를 피할 수 있었습니다.
  • Claude 모니터링 위젯 앱은 먼저 Tauri/Rust 접근이 빌드 도구 부재로 실패하고, Python 대안은 스레딩 충돌이 발생해 데이터가 제대로 표시되지 않았습니다. 구현 전에 기술적 전제조건을 확인했다면 이러한 차단 요소를 조기에 발견할 수 있었습니다.
주요 마찰 유형
잘못된 접근
19
버그 있는 코드
15
과도한 변경
3
외부 서비스 문제
3
사용자 작업 거부
2
다중 조정 필요
2
추정 만족도 (모델 추정)
불만
2
불만족
21
만족 추정
150
만족
19
매우 만족
3

추천 CC 기능

CLAUDE.md 추가 제안

Claude Code에 복사하여 붙여넣으면 CLAUDE.md에 추가됩니다.

여러 세션에서 Claude의 레이아웃 선택이 사용자 비전과 맞지 않아 3~5회 이상 수정 반복이 발생함 (대시보드 레이아웃, 통계 섹션, 컴포넌트 배치).
여러 세션에서 Claude가 2차 페이지를 놓침(예: 참여 페이지에 로그인 게이트 그대로, 이름 숨김이 주문 옵션도 숨김). 초기 푸시 후 사용자가 버그를 리포트해야 했음.
여러 세션에서 Claude가 잘못된 디버깅 접근에 5회 이상 반복 (마우스 클릭 문제, Tauri/Python 모니터링 위젯, 로켓 위치 버그). 근본 원인은 완전히 다른 영역에 있었음.
여러 세션에서 TypeScript 타입 오류 발생 (i18n 리터럴 타입, 구현 후 빌드 오류). 프로젝트가 TypeScript 중심(1344 파일 터치)이므로 빌드 검증이 자동화되어야 함.
한 세션은 이전 세션의 컨텍스트 부재로 완전히 실패했고, 여러 '이어서 하기' 워크플로우에서 추가 준비 시간이 필요했음.
여러 Godot 세션에서 타입 변환 오류 발생 (float에서 String, id/name 불일치). 기본적인 검증으로 잡을 수 있었음.

Claude Code에 복사하여 붙여넣으면 자동으로 설정됩니다.

Hooks
pre-commit이나 post-edit 같은 특정 라이프사이클 이벤트에서 셸 명령을 자동 실행합니다.
추천 이유: TypeScript 빌드 실패와 타입 오류가 커밋 전에 빈번하게 발생합니다. `tsc --noEmit`을 실행하는 pre-commit 훅을 설정하면 이를 자동으로 잡을 수 있습니다. 최소 4개 세션에서 이런 문제가 나타났습니다.
// .claude/settings.json에 추가 { "hooks": { "pre-commit": { "command": "npx tsc --noEmit 2>&1 | head -20", "description": "커밋 전 타입 체크" } } }
커스텀 스킬
단일 /command로 실행할 수 있는 마크다운 파일 형태의 재사용 가능한 프롬프트입니다.
추천 이유: 34개 이상의 세션에서 git 커밋+푸시를 수행하며(가장 많은 목표 카테고리), 리뷰+기획 워크플로우도 자주 사용합니다. 커스텀 스킬로 반복적 지시를 제거하고 git 및 기획 워크플로우를 표준화할 수 있습니다.
# .claude/skills/push/SKILL.md 파일 생성: # ## 푸시 워크플로우 # 1. 빌드 명령을 실행하고 오류를 수정 # 2. 테스트가 있으면 실행 # 3. `git add -A`로 모든 변경사항 스테이징 # 4. 변경사항을 요약하는 conventional 커밋 메시지 작성 # 5. 현재 브랜치에 푸시 # 그 다음 아무 세션에서나 /push 입력
Task Agent
Claude가 복잡한 탐색이나 병렬 작업을 위해 집중된 서브 에이전트를 생성합니다.
추천 이유: 다양한 프로젝트(트레이딩 봇, Godot 게임, 한국어 웹 앱, ComfyUI 노드, VitePress 문서)에 걸쳐 작업하며, 구현 전에 코드베이스 탐색이 자주 필요합니다. 서브 에이전트는 특히 멀티 파일 리팩터링 세션(36건의 멀티 파일 변경 성공)에서 병렬로 탐색하고 기획할 수 있습니다.
이렇게 프롬프트해 보세요: "에이전트를 사용해서 모든 라우트에 걸친 현재 인증 흐름을 탐색하고 로그인 상태를 확인하는 모든 페이지를 나열해 줘. 그 동안 내가 만들고 싶은 기능을 설명할게."

Claude Code 새로운 활용법

Claude Code에 복사하여 붙여넣으면 안내를 받을 수 있습니다.

레이아웃 결정을 목업으로 선행하기
다중 수정 반복을 피하기 위해 원하는 UI 레이아웃을 구조적으로 상세하게 사전에 설명하세요.
세션에서 반복되는 패턴이 있습니다: UI 변경을 요청하면, Claude가 자체 해석으로 구현하고, 수정을 요구하면 재구현하고, 이를 3~5회 반복합니다. 대시보드 레이아웃, 통계 섹션, 사이드바 배치, 컴포넌트 크기 조정에서 이 현상이 발생했습니다. 구조적 설명이나 ASCII 목업을 사전에 제공하면 이 반복 사이클을 60~70% 줄일 수 있습니다. 대시보드, 투표 앱, 게임 UI 작업에서 특히 관련이 있습니다.
Claude Code에 붙여넣기:
레이아웃을 재구성하려 해. 코드를 작성하기 전에, 정확한 그리드 구조(행, 열, 상대적 크기)가 포함된 텍스트 기반 목업을 보여줘. 구현 전에 내가 승인하거나 조정할게.
수정 시도 전에 근본 원인 분석 요청하기
잘못된 접근에 대한 반복 사이클을 피하기 위해 Claude에게 패치 전 진단을 요청하세요.
여러 세션에서 Claude가 적절한 진단 없이 바로 수정을 시도했습니다. 클릭 버그에 대해 5회 이상 잘못된 영역을 수정하고, 모니터링 위젯에 3가지 다른 기술 스택을 시도하고, 카메라 흔들림 문제를 위치 문제로 잘못 진단했습니다. '잘못된 접근' 마찰(19건)이 가장 높은 마찰 카테고리입니다. 진단 단계를 강제하면 버그 수정 세션(27개 이상) 전반에서 상당한 시간을 절약할 수 있습니다.
Claude Code에 붙여넣기:
변경하기 전에, 근본 원인을 분석해 줘. 관련 코드 경로를 읽고, 이 버그의 원인에 대한 상위 2~3개 가설을 설명하고, 어느 것이 가장 가능성이 높다고 생각하는지 이유와 함께 알려줘. 내가 진단을 확인할 때까지 파일을 수정하지 마.
다중 기능 세션에서 계획 후 구현 방식 사용하기
긴 세션을 명시적 계획 승인 게이트로 나누어 재작업과 잘못된 접근을 줄이세요.
가장 성공적인 세션(완전 달성)은 '커밋하고 푸시' 또는 '이 4개 노드 구현' 같은 명확한 단일 작업을 포함하는 경우가 많았습니다. 부분 달성 세션은 범위가 커지고 Claude가 잘못된 방향으로 가는 다중 기능 마라톤인 경향이 있습니다. 명시적 체크포인트를 만들면, 특히 트레이딩 봇 개선, 게임 기능 추가, 웹 앱 반복 세션에서 완료율이 개선되고 19건의 '잘못된 접근' 마찰 이벤트가 줄어듭니다.
Claude Code에 붙여넣기:
이번 세션에서 할 일이 여러 가지 있어. 하나씩 진행하자. 먼저 내가 설명한 것을 바탕으로 작업 목록을 정리해 줘. 각 작업이 완료되고 푸시된 후에 다음으로 넘어가자. 내가 확인할 때까지 다음 작업을 시작하지 마.

미래 전망

게임 개발, 트레이딩 봇, 웹 앱, 도구 등 66개 세션은 대화형 반복에서 마찰과 수정 사이클을 극적으로 줄이는 자율적 멀티 에이전트 워크플로우로 전환할 준비가 된 파워 유저를 보여줍니다.

병렬 테스트 기반 버그 수정 에이전트
가장 높은 마찰 원인인 잘못된 접근(19건), 버그 있는 코드(15건), 5회 이상의 클릭 수정 같은 다중 반복 디버깅은 각각 다른 수정 가설을 제안하고, 테스트로 검증하고, 성공한 솔루션만 표시하는 병렬 에이전트를 생성함으로써 제거할 수 있습니다. 순차적 추측과 확인 대신, 세 개의 에이전트가 동시에 그린 빌드를 향해 경쟁합니다.
시작하기: Claude Code의 서브 에이전트 생성 또는 Task 도구를 사용해 병렬 조사 브랜치를 분기하고, 각각 결과를 보고하기 전에 테스트를 실행하도록 제한합니다. TodoWrite와 결합하여 구조화된 가설 추적을 할 수 있습니다.
Claude Code에 붙여넣기:
버그가 있어: [증상 설명]. 수정을 시도하기 전에, 가능성 순으로 3가지 근본 원인 가설의 TodoWrite 목록을 만들어. 그런 다음 각 가설에 대해 별도의 Task 서브 에이전트를 사용해서: (1) 가설을 확인하는 실패하는 테스트 작성, (2) 최소한의 수정 시도, (3) 전체 테스트 스위트 실행. 모든 테스트가 통과하는 가설만 보고해. 성공한 가설이 확인될 때까지 메인 코드베이스를 수정하지 마. 어떤 가설도 통과하지 않으면, 학습한 내용을 종합하고 새로운 라운드를 제안해.
가드레일이 있는 자율 멀티 파일 리팩터링
멀티 파일 변경이 상위 성공 패턴(36개 세션)이지만, 잘못된 접근 마찰(19건)은 Claude가 되돌려야 하는 방향에 커밋하는 경우를 의미합니다. Tauri에서 Python으로의 전환이나 편광 오해 같은 경우입니다. 자율 리팩터링 워크플로우는 샌드박스 git 브랜치에서 대규모 변경을 실행하고, 전체 빌드와 테스트 스위트를 실행하며, 모든 것이 통과할 때만 승인을 위해 diff를 제시할 수 있습니다. 이를 통해 "거의 달성" 세션을 "완전 달성"으로 바꿀 수 있습니다.
시작하기: Claude가 기능 브랜치를 생성하고, 각 단계에서 빌드 검증과 함께 점진적으로 변경을 구현하며, Bash를 사용해 기존 테스트/빌드 명령을 커밋 전 자동 게이트로 실행하도록 프롬프트를 구조화하세요.
Claude Code에 붙여넣기:
다음 리팩터링 계획을 자율적으로 구현해: [변경 설명]. 이 워크플로우를 엄격히 따라: 1. 'refactor/[설명적 이름]' 이름의 새 git 브랜치 생성 2. 코드 변경 전에 수정할 모든 파일을 읽고 TodoWrite 체크리스트에 나열 3. 한 번에 하나의 파일만 변경하고, 각 파일 편집 후 빌드 실행 4. 빌드가 실패하면 해당 단일 파일 변경을 되돌리고 대안 접근 시도 5. 모든 파일이 수정되고 빌드가 통과하면, 전체 테스트 스위트 실행 6. 테스트가 실패하면 수정하되 테스트를 절대 건너뛰지 않음 7. 그린이 되면, 파일별로 정리된 완전한 `git diff main` 요약을 1줄 설명과 함께 보여줘 8. main에 머지하지 말고 내 승인을 기다려 지금 시작해.
시각적 스펙을 활용한 자가 검증 UI 구현
레이아웃과 UI 세션에서 Claude의 공간적 해석이 비전과 다르기 때문에 일관되게 3~5회 수정 반복이 필요합니다. 대시보드 크기, 컴팩트 통계 되돌리기, 차트 배치 등이 그렇습니다. 구조화된 시각적 명세를 사전에 작성하고 Claude가 다음으로 넘어가기 전에 각 컴포넌트를 명시적 제약 조건에 대해 검증하도록 하면, 이 반복 사이클을 한 번의 패스로 압축할 수 있습니다. 스크린샷 도구와 결합하면 Claude가 자체적으로 출력을 확인할 수도 있습니다.
시작하기: TodoWrite를 사용해 UI 작업을 명시적 픽셀/퍼센트 제약 조건이 포함된 개별 검증 가능한 컴포넌트로 분해하세요. Claude가 개발 서버를 실행하고 Bash를 사용해 렌더링된 DOM 측정값이 스펙과 일치하는지 검증 체크포인트로 확인하도록 하세요.
Claude Code에 붙여넣기:
UI 레이아웃을 구현해야 해. 코드를 작성하기 전에, 레이아웃에 대해 구체적인 질문을 해 줘: - 각 섹션의 정확한 비율 (퍼센트 또는 px) - 컴포넌트 우선순위 (뷰포트가 좁을 때 어떤 것이 먼저 공간을 받는지) - 하지 말아야 할 특정 사항 (예: 차트를 나란히 배치하지 말 것, fr 단위 사용하지 말 것) 내가 답변한 후, 각 UI 컴포넌트를 정확한 크기 제약 조건이 포함된 별도의 체크리스트 항목으로 TodoWrite 스펙을 작성해. 그런 다음 이 순서로 하나씩 구현해: 1. 컴포넌트 구현 2. `npm run dev` 실행하고 빌드 오류 없는지 확인 3. Bash를 사용해 렌더링된 DOM 측정값이 스펙과 일치하는지 확인 (예: computed style 확인 또는 headless 브라우저 사용) 4. TodoWrite 항목 완료 표시 5. 다음 컴포넌트로 이동 크기나 배치가 불확실한 시점이 있으면, 추측하지 말고 멈추고 물어봐. 2개 컴포넌트마다 실행 결과를 보여줘.
"Claude가 깨진 마우스 클릭 버그를 수정하려고 5회 이상 시도 — 라우트 변경, 로케일 파일, 심지어 프론트엔드 다운그레이드까지 — 결국 사용자가 브라우저 스토리지 문제임을 밝혀냄"
ComfyUI 개발 세션에서 Claude는 깨진 UI 클릭에 대해 점점 더 필사적인 수정의 토끼굴에 빠져들었지만, 실제 범인은 처음부터 오래된 브라우저 스토리지였습니다. 사용자가 직접 이 헛된 추적을 지적해야 했습니다.