35개 세션(전체 116개)에서 371개 메시지 | 2026-06-07 ~ 2026-07-13
한눈에 보기
잘 되고 있는 점: 브라우저 렌더링과 스크린샷을 활용해 UI와 슬라이드 변경 사항이 컴파일만 되는 것이 아니라 실제로 제대로 보이는지 확인한 후 커밋하는 긴밀한 검증-후-커밋 루프를 운영합니다. 또한 '완료'를 배포되어 실제로 동작하는 상태로 여기며, 기획부터 빌드, 폰 설치, GitHub·PyPI 푸시까지 한 흐름으로 처리하는 경우가 많습니다. 버그가 발생했을 때도 빠른 땜질보다 진짜 근본 원인 진단(경쟁 조건, 스폰을 깨뜨리는 사용자명 문제 등)을 꾸준히 요구했습니다. 인상적인 성과 →
방해가 되는 점: Claude 쪽에서는 일부 편집이 추측한 텍스트를 기준으로 앵커링되어 다시 작업해야 했고, 한 서브에이전트는 거짓말하는 테스트 하네스 때문에 존재하지 않는 유령 버그를 쫓았으며, 몇몇 실현 가능성 판단이 대화 도중 번복되어 잠시 신뢰를 잃기도 했습니다. 사용자 쪽에서는 범위나 플랫폼 동작을 초반에 명확히 하지 않아 재작업이 발생한 경우가 있었습니다 -- KLayout만 원했는데 완전한 EDA 서버가 만들어지거나, 접근 방식이 실패한 후에야 Godot의 Container 특성을 발견한 경우입니다. 환경적 문제(누락된 키스토어, 차단된 네트워크, 플랜 제한)도 사전에 드러나기보다 작업 도중에 나타나는 경향이 있었습니다. 문제가 발생한 부분 →
빠르게 시도할 수 있는 것: 빌드-검증-배포 사이클을 계속 반복하므로, 이를 커스텀 스킬로 만들어 두세요 -- GA 스니펫 삽입, 덱 렌더링 확인, APK 빌드 및 설치 흐름을 재사용 가능한 슬래시 명령어로 만들 수 있습니다. 편집 후 Playwright 검증이나 빌드를 자동 실행하는 훅은 검증 루프를 더욱 촘촘하게 만들어 주며, Task 에이전트는 대규모 플랫폼 빌드에서 탐색 작업을 병렬화할 수 있습니다. 시도해볼 CC 기능 →
야심찬 워크플로우: 모델이 발전하면, 에이전트가 테스트 하네스를 신뢰하기 전에 스스로 검증한 다음 모든 어설션이 실제로 통과할 때까지 스크린샷과 헤드리스 렌더를 대상으로 자율적으로 반복하여, 검토하기도 전에 유령 버그를 잡아낼 수 있을 것입니다. 또한 모든 환경 제약(키스토어, SDK, 네트워크 차단, 플랜 제한)을 사전 점검하는 병렬 빌드-배포 에이전트를 여러 개 동시에 실행하여 블로커가 한 번에 하나씩이 아니라 미리 드러나게 할 수 있습니다. 그리고 조사 우선 에이전트가 아무것도 건드리기 전에 실패를 재현하여 코드·설정·네트워크 문제를 구분해내고, 추측 후 땜질하던 방식을 증거 기반 수정과 회귀 테스트로 고정하는 방식으로 전환할 수 있습니다. 향후 가능성 →
371
메시지
+30,683/-2,189
라인
379
파일
17
일수
21.8
일평균
주요 작업 영역
Godot 게임 개발약 8개 세션
산수 무한 점프 게임, MathPunch를 참고한 3D 엔드리스 러너 수학 게임, 조명과 난이도 조정이 들어간 호러 게임 등 여러 Godot 게임을 만들고 반복 개선했습니다. Claude Code는 설계부터 배포까지 전체 사이클을 처리하고, 경쟁 조건과 Container 스케일링 버그를 진단했으며, 헤드리스 렌더링과 스크린샷으로 검증하고, Android 폰에 APK를 빌드·설치했습니다. 맵이 사라지는 문제나 Godot의 스케일 초기화 동작 같은 까다로운 이슈의 근본 원인을 찾아내는 작업도 포함되었습니다.
AgentGuard 멀티 에이전트 보안 도구약 4개 세션
폴더 단위 거부/허용 정책, 인트라넷 보안 프리셋, 우클릭 정책과 상속 색상 표시 기능을 갖춘 파일시스템 탐색기로 멀티 에이전트 설정을 관리하는 애플리케이션 AgentGuard를 개발했습니다. Claude Code는 백엔드와 프론트엔드 전반을 구현하고, 새 아이콘과 포터블 실행 파일을 갖춘 계층형 설정 UI를 설계했으며, Windows 경로 규칙을 공식 문서와 대조해 검증했습니다. 빌드 환경 문제(누락된 Windows SDK, 잠긴 실행 파일)는 코드 문제가 아닌 것으로 진단되었습니다.
프레젠테이션 덱 및 세미나 사이트약 12개 세션
바이브 코딩, 초보자를 위한 Claude Code 같은 주제의 HTML/reveal.js 프레젠테이션 덱을 다수 제작·개선하며, 텍스트 위주 슬라이드를 더 시각적이고 애니메이션이 들어간 형태로 재설계했습니다. Claude Code는 새로운 챕터와 슬라이드를 추가하고, 스크롤 가능한 ESC 개요 같은 내비게이션 기능을 구현했으며, 센터링과 전환 효과를 수정하고 Google Analytics 스니펫을 삽입했습니다. Playwright를 통한 광범위한 브라우저 검증으로 공개 세미나 사이트에 커밋·푸시하기 전 렌더링이 올바른지 확인했습니다.
실시간 Q&A / 협업 플랫폼약 6개 세션
실시간 Q&A 스티키 노트, 투표, 이모지 반응, 발표자가 제어하는 테마 시스템 등 실시간 인터랙티브 기능을 만들어 프로덕션에 배포했습니다. Claude Code는 실시간 큐 재정렬로 인한 포커스 탈취 문제의 근본 원인을 찾아내고, 회귀 테스트와 함께 사용자명/스폰 버그를 수정했으며, Vercel과 Cloudflare에서의 배포 실현 가능성을 평가했습니다. 디자인 가이드라인을 준수하며 여러 마일스톤에 걸쳐 Confluence를 대체하는 전체 플랫폼을 구축하는 작업도 포함되었습니다.
KLayout MCP 서버 및 문서 도구약 3개 세션
GDS 드로잉, 편집, DRC, 배치 배선을 위한 독립형 KLayout MCP 서버를 점진적으로 구축했으며, 완전한 EDA 서버에서 GitHub와 PyPI에 게시하는 경량 Python 패키지로 다듬었습니다. Claude Code는 MkDocs와 VitePress 문서 사이트를 설정하고, GitHub Pages와 PyPI CI 파이프라인을 구성했으며, 에이전트 스킬을 만들었습니다. 비공개 저장소에 대한 GitHub Free 플랜 제한 같은 외부 제약이 종종 Pages 배포를 막았습니다.
요청 유형
기능 구현
48
버전 관리
17
Git 작업
14
콘텐츠 편집
8
콘텐츠 생성
7
배포
5
주요 사용 도구
Edit
940
Bash
828
Read
648
PowerShell
250
Write
250
Grep
145
프로그래밍 언어
TypeScript
575
HTML
336
Python
150
Markdown
128
Rust
32
JSON
28
세션 유형
다중 작업
16
반복 개선
12
단일 작업
7
Claude Code 사용 방식
당신은 Claude가 오래도록 자율적으로 작업하도록 신뢰하는 목표 지향적 위임자입니다. 세션당 메시지는 약 10개뿐인데 평균 10시간이 넘게 이어진다는 점이 이를 명확히 보여줍니다 -- 야심찬 다단계 목표를 넘겨주고 각 단계를 일일이 관리하기보다 Claude가 처음부터 끝까지 실행하도록 맡깁니다. 'Godot으로 완전한 3D 엔드리스 러너 수학 게임을 만들어줘', '실시간 Q&A 스티키 노트 기능을 구현하고 테스트, 리뷰, 머지까지 해줘', '다마일스톤 Confluence 대체 플랫폼을 처음부터 만들어줘' 같은 요청에는 검증, 커밋, 배포까지 암묵적으로 포함되어 있습니다. 거의 항상 버전 관리를 요청 자체에 포함시키며 -- '커밋하고 푸시해줘'라는 말이 끊임없이 등장합니다 -- Claude를 단순히 코드를 작성하는 존재가 아니라 전체 전달 파이프라인을 책임지는 자율적인 엔지니어로 대합니다.
작업 방식은 세션 내에서는 강하게 반복적이지만 요청 단위로는 일괄적으로 처리됩니다. 처음부터 상세한 스펙을 작성하기보다 명확한 목표를 제시하고, 브라우저나 스크린샷으로 검증된 결과를 검토한 다음 개선 사항을 덧붙이는 방식을 선호합니다 -- 버튼 크기를 두 배로 늘리거나, 축하 효과를 추가하거나, 슬라이드 애니메이션을 조정하거나, 새 콘텐츠로 교체하는 식입니다. 이는 프레젠테이션과 게임 작업에서 잘 드러나는데, 슬라이드 단위로 점진적으로 덱을 다듬고 수많은 작은 지시를 통해 게임의 느낌(조명, 캐릭터 스케일, 난이도)을 조율합니다. 시각적 검증을 분명히 중요하게 여기는데, 활발한 Playwright 브라우저 탐색과 스크린샷 사용, 그리고 헤드리스 렌더링과 APK 폰 설치까지 활용하는 모습에서 Claude가 '완료'를 선언하기 전에 실제로 동작한다는 것을 증명하길 기대한다는 것을 알 수 있습니다.
방향이 잘못되었을 때는 드물지만 단호하게 개입합니다. 대부분의 마찰은 Claude 쪽에서 비롯되었으며(잘못된 편집 앵커 추측, KLayout만 원했는데 완전한 EDA 서버를 설치하는 등의 범위 과다, 유령 테스트 하네스 버그), 지적은 날카롭고 구체적이었습니다 -- 스케줄 기본값을 3에서 다시 4로 되돌리거나, 어울리지 않는 빌런 얼굴을 거부하거나, 잘못된 프롬프트 예시를 다시 구성한 사례가 있습니다. 거의 모든 목표에서 만족(35건 중 29건 완전 달성, 불만족은 1건)했다는 점은 이 높은 신뢰의 위임-후-검증 방식이 잘 맞는다는 것을 보여줍니다. 특히 Claude가 Cloudflare 실시간 기능의 실현 가능성에 대해 스스로 판단을 번복했을 때 잠시 포기했다는 점은, Claude의 기술적 판단을 사실로 신뢰한다는 것을 시사하며, 그래서 모순된 답변이 버그보다 더 큰 대가를 치르게 한다는 것을 보여줍니다.
핵심 패턴: 커밋, 배포, 검증까지 포함한 크고 완결된 목표를 위임한 다음 Claude가 몇 시간이고 자율적으로 실행하도록 두고, 날카롭고 구체적인 방향 수정이 필요할 때만 개입합니다.
사용자 응답 시간 분포
2-10초
13
10-30초
18
30초-1분
28
1-2분
44
2-5분
56
5-15분
38
>15분
38
중앙값: 151.5초 • 평균: 405.5초
멀티 클로딩 (병렬 세션)
2
겹침 이벤트
4
관련 세션
2%
전체 메시지 중
여러 Claude Code 세션을 동시에 실행합니다. 멀티 클로딩은 세션이 시간적으로 겹칠 때 감지되며, 병렬 워크플로우를 시사합니다.
시간대별 사용자 메시지
오전 (6-12)
52
오후 (12-18)
41
저녁 (18-24)
240
야간 (0-6)
38
도구 오류 발생
기타
59
명령 실패
33
파일 없음
8
파일 너무 큼
7
편집 실패
6
사용자 거부
4
인상적인 성과
게임 개발, 프레젠테이션 덱, MCP 서버, 풀스택 플랫폼을 아우르는 35개 세션에서, 복잡한 프로젝트를 구상 단계부터 검증된 배포까지 꾸준히 이끌어냈습니다.
브라우저로 검증하는 시각적 반복 개선
커밋 전에 모든 UI와 슬라이드 변경 사항을 Playwright로 탐색하고 스크린샷을 찍어 검증하는 데 크게 의존합니다. 이 긴밀한 검증-후-커밋 루프는 헤드리스 렌더링으로 발견한 잘못 배치된 버튼 설정 블록 같은 실제 버그를 잡아냈으며, reveal.js 덱과 앱 UI가 컴파일만 되는 것이 아니라 실제로 올바르게 렌더링된다는 확신을 주었습니다.
빠른 땜질보다 근본 원인 디버깅
게임 맵이 사라졌을 때, 무작정 리팩토링을 받아들이는 대신 체계적인 진단을 요구하여 버그를 startGame의 경쟁 조건으로 추적해냈습니다. 게스트가 아닌 사용자명이 스폰을 깨뜨리거나 회사 네트워크가 workers.dev를 차단하는 등, 진짜 원인을 찾는 방식을 반복적으로 선호했으며, 이는 지저분한 실시간 플레이 버그를 회귀 테스트가 딸린 견고한 수정으로 바꾸어 놓았습니다.
엔드투엔드 빌드-배포 출시
기획부터 구현, 테스트, APK 빌드, 폰 설치, git 푸시까지 하나의 흐름으로 처리하는 경우가 많습니다. Godot 엔드리스 러너를 Android 기기에 출시하든, CI와 함께 KLayout MCP 서버를 GitHub와 PyPI에 게시하든, '완료'를 코드를 작성한 상태가 아니라 배포되어 실제로 동작하는 상태로 여깁니다.
가장 도움된 기능 (Claude의 역량)
다중 파일 변경
14
정확한 코드 수정
8
좋은 디버깅
8
선제적 도움
4
좋은 설명
1
달성도
대부분 달성
6
완전 달성
29
문제가 발생한 부분
세션은 압도적으로 성공하는 편이지만, 마찰은 편집 앵커 추측, 크로스플랫폼/환경 세부사항에 대한 잘못된 초기 판단, 그리고 잠시 궤도를 벗어나게 만든 몇몇 번복되거나 모순된 판단에 집중되어 있습니다.
무작정 편집 앵커링
정확한 주변 맥락을 먼저 읽지 않고 추측한 앵커 텍스트나 위치에 대해 편집을 반복적으로 실행하여 재작업을 강제했습니다. 편집 직전에 대상 영역을 읽으면 이런 재시도를 없앨 수 있습니다.
GA 스니펫을 다시 삽입하는 첫 번째 Edit이 앵커 텍스트를 잘못 추측해 실패했고, 수정된 두 번째 Edit이 필요했습니다.
슬라이드 18에서 편집을 잘못된 위치에 앵커링하여 다시 올바르게 수정해야 했습니다.
잘못된 초기 접근 방식과 범위
플랫폼 동작이나 사용자의 실제 의도를 확인하기 전에 구현 방식이나 범위를 먼저 정해버려 이후 구조를 다시 짜야 했던 경우가 있습니다. 프레임워크의 특성을 미리 검증하고 범위를 명확히 하면 전체 재작업 사이클을 아낄 수 있습니다.
사용자가 KLayout만 원했는데 완전한 eda-mcp 서버를 만들어, 경량 독립형 서버로 다시 만들어야 했습니다.
Container가 레이아웃 패스마다 자식 노드의 스케일을 초기화하는 바람에 스케일 기반 Godot 접근 방식이 실패하여, 래퍼 노드 구조로 다시 짜야 했습니다.
번복되고 모순된 판단
실현 가능성이나 근본 원인에 대해 단호한 결론을 내렸다가 나중에 뒤집는 경우가 간혹 있었고, 이는 잠시 사용자가 포기하거나 신뢰를 잃게 만들었습니다. 불확실한 주장에 대해 여지를 남기고 환경적 원인을 더 일찍 조사했다면 이런 혼란을 막을 수 있었을 것입니다.
Cloudflare 실시간 기능이 불가능하다고 말했다가 Durable Objects를 통해 가능하다고 번복하여, 사용자가 잠시 포기하게 만들었습니다.
게시/락 조사에서 진짜 원인(회사 네트워크의 workers.dev 차단)이 드러나기 전에 코드 버그를 먼저 쫓아 진단이 지연되었습니다.
주요 마찰 유형
버그 있는 코드
6
잘못된 접근
6
환경 문제
2
사용자 거부
2
요청 오해
2
추정 만족도 (모델 추정)
불만족
1
만족 추정
132
만족
11
매우 만족
2
시도해볼 CC 기능
CLAUDE.md 추가 제안
Claude Code에 복사하여 붙여넣기하면 CLAUDE.md에 추가됩니다.
성공한 세션 대부분이 커밋 전 브라우저/헤드리스 검증으로 잘못 배치된 편집과 렌더링 버그를 잡아내는 데 의존했습니다.
GA 스니펫 보존/삽입은 최소 4개의 세미나 사이트 세션에서 반복되었으며, 한 번은 잘못된 앵커 추측 후 수정된 재삽입이 필요했습니다.
여러 세션에서 Windows 특유의 환경 문제(잠긴 exe, 누락된 Windows SDK, cp949, Celery 풀)를 코드 문제로 착각하여 시간을 낭비했습니다.
최소 두 세션에서 실제 원인이 차단된 네트워크나 GitHub Free 플랜 제한이었음에도 처음에는 코드 버그를 쫓았습니다.
경량 KLayout 도구만 원했는데 Claude가 완전한 eda-mcp 서버를 만들어 재작업이 필요했습니다.
Claude Code에 복사하여 붙여넣기하면 설정해 줍니다.
Custom Skills
반복적인 워크플로우를 위해 마크다운으로 저장하는 재사용 가능한 /명령어 프롬프트입니다.
왜 필요한가: commit/push와 덱 배포(덱 복사, GA 삽입, 빌드, 썸네일 생성, 푸시)를 여러 번 반복했습니다 -- 스킬로 만들면 각각을 하나의 명령어로 압축할 수 있습니다.
Create .claude/skills/deploy-deck/SKILL.md with: 'Copy the deck to the site, re-insert the GA snippet, generate a thumbnail, add the card, build, verify in browser via Playwright, then commit and push.' Then run /deploy-deck
Hooks
편집 후 같은 라이프사이클 이벤트에서 자동 실행되는 쉘 명령입니다.
왜 필요한가: 940건의 Edit과 TypeScript/Python 위주 작업을 고려하면, 포매터나 타입 체크를 실행하는 PostToolUse 훅이 (ResultsController 버튼 버그 같은) 잘못 배치된 코드 오류를 자동으로 잡아낼 수 있습니다.
왜 필요한가: 복잡한 다마일스톤 플랫폼과 게임을 만들었습니다. 코드베이스 탐색을 에이전트에게 위임하면 근본 원인 파악 속도가 빨라지지만, 이전에 한 에이전트가 유령 테스트 하네스 버그를 쫓은 적이 있으므로 에이전트의 범위를 엄격히 제한해야 합니다.
Ask: "Use an agent to trace the startGame race condition and report the root cause before editing anything."
Claude Code 활용 새 패턴
Claude Code에 복사하여 붙여넣기하면 과정을 안내해 줍니다.
결과를 신뢰하기 전에 테스트 하네스부터 검증하기
서브에이전트가 결과를 바탕으로 행동하게 하기 전에, 테스트 러너가 실제 성공/실패를 제대로 보고하는지 확인하세요.
한 세션에서는 결함 있는 하네스가 컴파일 실패를 통과로 보고하는 바람에 서브에이전트가 존재하지 않는 'find_children 특이 동작'을 쫓았습니다. Godot/헤드리스 테스트를 많이 하기 때문에, 잘못된 하네스는 디버깅을 소리 없이 잘못된 방향으로 이끕니다. 먼저 알려진 실패 케이스로 하네스를 검증하세요. 이렇게 하면 낭비되는 진단 루프를 막을 수 있습니다.
Claude Code에 붙여넣기:
Before relying on the test output, verify the test runner correctly reports failures by feeding it a deliberately broken case.
디버그 폴백이 아닌 릴리스 빌드로 출시하기
모바일 APK를 빌드하기 전에 릴리스 키스토어/설정이 존재하는지 확인하세요.
한 폰 설치 세션에서는 릴리스 키스토어가 없어 조용히 디버그 빌드로 대체되었습니다. Godot APK를 Android 폰에 빌드·설치하는 작업을 반복적으로 하고 있습니다. 서명 설정을 사전에 확인하면 잘못된 산출물을 전달하는 것을 막을 수 있습니다. 이를 빌드 전 체크리스트 항목으로 만드세요.
Claude Code에 붙여넣기:
Before building the APK, check whether the release keystore is present; if it is, produce a signed release build, otherwise stop and tell me.
대형 HTML 덱에서 편집 앵커를 정확히 잡기
잘못된 앵커 실수를 피하려면 슬라이드를 편집하기 전에 정확한 주변 라인을 먼저 읽으세요.
여러 세션에서 편집이 처음에 잘못된 슬라이드 위치(슬라이드 18, GA 스니펫)에 배치되어 재작업이 필요했습니다. 덱은 추측한 앵커가 빗나가기 쉬운 대형 HTML/reveal.js 파일입니다. 먼저 근처의 고유한 문자열을 grep으로 찾아 정확한 위치를 확정하세요. 이렇게 하면 재작업 부담을 줄일 수 있습니다.
Claude Code에 붙여넣기:
Before editing this slide, grep for the exact unique text near the target and show me the surrounding lines so the anchor is correct.
가정은 한 번만 밝히고, 실현 가능성은 신중하게 확인하기
플랫폼 기능(예: Cloudflare 실시간 기능)에 대한 판단을 이랬다저랬다 하지 마세요.
Claude가 Cloudflare 실시간 기능이 불가능하다고 했다가 Durable Objects로 번복했을 때 잠시 신뢰를 잃었습니다. 배포 실현 가능성을 평가할 때는 판단을 내리기 전에 플랫폼의 기능을 먼저 조사하세요. 자신 있게 틀린 답 하나보다 잘 조사된 답 하나가 낫습니다. 이는 Vercel/Cloudflare 관련 결정에서 중요합니다.
Claude Code에 붙여넣기:
Before giving a feasibility verdict on this platform, research its realtime/edge capabilities and give me one grounded answer with sources.
향후 가능성
AI 지원 개발은 단일 작업 편집에서, 에이전트가 계획하고, 빌드하고, 실제 브라우저와 기기로 테스트하며, 전체 애플리케이션을 처음부터 끝까지 출시하는 자율적이고 자기 검증적인 워크플로우로 진화하고 있습니다.
자가 치유형 테스트 하네스 검증 루프
컴파일 실패를 통과로 보고한 적 있는 테스트 러너를 그대로 신뢰하는 대신, 에이전트가 반복하기 전에 스스로 하네스를 검증한 다음 모든 시각적·기능적 어설션이 실제로 통과할 때까지 Playwright 스크린샷과 헤드리스 렌더를 대상으로 자율적으로 반복할 수 있습니다. 이는 커밋 위주 워크플로우를 검토하기도 전에 잘못 배치된 코드와 유령 버그를 잡아내는 자가 수정형 빌드 집단으로 바꿔놓습니다. 에이전트는 거짓말할 수도 있는 하네스가 아니라 스스로의 사실 판단에 책임을 지게 됩니다.
시작하기: Bash 기반 테스트 루프와 함께 Playwright MCP로 브라우저 검증을 수행하고, 알려진 실패를 주입해 하네스가 정직한지 먼저 증명하도록 Claude에게 지시하세요. git 체크포인트와 결합하여 검증된 각 반복이 안전하게 커밋되도록 하세요.
Claude Code에 붙여넣기:
Build feature X with a fully autonomous verify-and-iterate loop. Before trusting any test results, sanity-check the test harness itself by introducing a deliberate compile error and confirming it reports FAILURE (not pass) — fix the harness if it lies. Then iterate: implement, run tests, capture Playwright screenshots and headless renders, diff against expected UI, and repeat until 100% pass with visual confirmation. Commit each verified milestone with descriptive messages, and only stop when every assertion genuinely passes.
병렬 멀티 플랫폼 빌드 및 배포 에이전트
세션에서 게임, 문서 사이트, 웹 앱을 반복적으로 만든 다음 Android 폰, GitHub Pages, PyPI, Vercel에 배포했는데, 대부분 순차적으로 진행하며 키스토어, 네트워크, 플랜 제한 문제를 하나씩 만났습니다. 릴리스 APK 빌드, 웹 대상 배포, 패키지 게시를 동시에 수행하고 모든 환경 제약(키스토어, Windows SDK, 네트워크 차단, 플랜 제한)을 사전 점검하는 병렬 에이전트를 실행하면 블로커가 작업 도중이 아니라 미리 드러납니다. 하나의 오케스트레이터가 플랫폼별 작업을 분배하고 결과를 하나의 출시 준비 완료 보고서로 취합합니다.
시작하기: Task 도구를 사용해 배포 대상별로 병렬 서브에이전트를 실행하고, 플랫폼 빌드에는 Bash/PowerShell을, 실제 검증에는 MCP 브라우저 확인을 활용하세요. 오케스트레이터가 먼저 환경 사전 조건을 수집하도록 하여 누락된 키스토어나 차단된 네트워크가 실행 중인 파이프라인을 멈추지 않도록 하세요.
Claude Code에 붙여넣기:
Act as a deployment orchestrator. Launch parallel subagents, one per target: (1) build and sign the Android release APK — verify keystore exists first and report if missing, (2) build and deploy the web app, (3) publish the Python package, (4) audit all environment prerequisites (Windows SDK, encoding, network egress, GitHub plan limits, locked files) BEFORE any build starts. Each subagent verifies its own success via real device install, live URL check, or registry query. Merge results into one report listing what shipped and any external blockers, and commit/push all changes.
코드 변경 전 자율 근본 원인 진단
여러 세션에서 실제로는 환경적인 문제(workers.dev를 차단하는 회사 네트워크, startGame의 경쟁 조건, 스폰을 깨뜨리는 게스트가 아닌 사용자명)였음에도 에이전트가 '코드를 고치며' 시간을 낭비했습니다. 조사 우선 에이전트는 실패를 재현하고, 원인이 코드인지 설정인지 환경인지 네트워크인지 구분한 다음, 이전에 올바르게 했던 것처럼 불필요한 리팩토링은 하지 말라고 권고하면서 수정을 영구히 고정하는 회귀 테스트를 만들 수 있습니다. 이는 추측 후 땜질하던 사이클을 절대 회귀하지 않는 증거 기반 수정으로 전환시킵니다.
시작하기: 아무것도 편집하기 전에 Grep, Read, Bash 재현 스크립트를 사용한 체계적인 근본 원인 진단 절차를 실행하도록 Claude에게 지시하고, 증거를 갖춘 가설을 문서로 요구하세요. 기존 테스트 도구를 통해 각 수정을 영구히 지켜주는 회귀 테스트를 생성하도록 하세요.
Claude Code에 붙여넣기:
Bug: [describe]. Do NOT change any code yet. First run a structured root-cause investigation: reproduce the failure deterministically, then rule in/out each layer — application code, config, environment (encoding, file locks, SDK), and network/external constraints. State your evidence-backed hypothesis before proposing a fix. If the root cause is environmental or external, say so clearly instead of patching code. Once confirmed, implement the minimal fix, add a regression test that fails without it and passes with it, verify via the test suite plus browser/headless render, and commit. Explicitly recommend against any refactor that isn't required.
"컴파일 실패를 통과로 보고하는 거짓말쟁이 테스트 러너에게 속아, 서브에이전트가 존재하지도 않는 유령 Godot 'find_children 특이 동작'을 쫓아다녔다"
산수 무한 점프 Godot 게임을 만드는 도중, Claude는 개발을 멈추고 자신의 테스트 하네스가 망가진 코드를 통과로 도장 찍고 있었다는 것을 진단해야 했습니다 -- 버그는 선수가 아니라 심판에게 있었습니다.