결과가 잘 안 나온다면 /insights 명령어를 써보세요
Use /insights if you're struggling to get results
핵심 요약
Claude Code의 /insights 명령어를 활용해 워크플로우를 분석하고 코드 품질과 작업 효율을 높이는 방법을 공유합니다.
- /insights 명령어 — Claude Code가 작업 패턴을 분석하여 개선점을 제안함.
- 워크플로우 최적화 — 수동 작업의 문제점을 파악하고 자동화된 검증 단계를 도입함.
- 코드 품질 향상 — 테스트 주도 개발과 엄격한 검증으로 오류를 줄임.
- 성능 개선 전략 — 프로파일러 기반의 자율 에이전트로 근본 원인을 해결함.
이 도구가 존재하는 줄 몰라서 한 번도 안 써봤는데, 슬래시 명령어 목록을 보다가 발견해서 그냥 한번 실행해 봤습니다. CLAUDE.md에 추가할 유용한 코드 줄들과 몇 가지 유용한 스킬 및 훅(hook)을 알려주더군요. 이 기능을 몰랐던 많은 분들의 워크플로우를 개선할 수 있을 것 같습니다. 제가 받은 결과는 다음과 같습니다:
한눈에 보기
잘하고 있는 점: 당신은 훈련된 엔지니어링 리드처럼 Claude를 운영하고 있습니다. 수 시간 동안 진행되는 단계별 Burst/ECS 최적화 캠페인이나 대규모 Spline-to-skeleton 마이그레이션을 핸드오프 문서와 컨텍스트 앵커를 포함한 번호가 매겨진 슬라이스로 구조화합니다. 당신은 커밋을 수락하기 전에 프로파일러 계측, 특성 테스트, 전체 테스트 스위트 통과와 같은 경험적 증거를 일관되게 요구하며, 이를 통해 39배의 BuildMesh 속도 향상과 주요 힙 압력 감소와 같은 검증된 성과를 만들어냈습니다. 또한 표면적인 패치가 아닌 어려운 버그(교차 프레임 레이스, 도메인 리로드 누수, 네임스페이스 섀도잉)의 근본 원인을 파악하려는 점도 훌륭합니다. 당신이 해낸 인상적인 일들 →
방해 요소: Claude 측에서는 특히 메시 지오메트리와 셰이더 작업 시, 약한 테스트는 통과하지만 법선이 뒤집히거나 구멍이 생기거나 식물이 어두워지는 대신 밝아지는 등 수렴하기 전에 퇴보하는 시행착오 수정 패턴이 반복됩니다. 당신 측에서는 주로 환경적 마찰이 발생합니다. 잘못된 Unity 워크트리를 대상으로 검증을 실행하거나 에디터가 닫힌 상태에서 실행하여 조작된 것처럼 보이는 지표를 생성하거나, 심지어 메인 브랜치에 잘못된 병합을 하기도 했습니다. 또한 셸 heredoc 인용이 커밋 메시지를 반복적으로 망가뜨렸습니다. 문제가 발생하는 지점 →
시도해 볼 만한 빠른 승리: 이미 수동으로 하고 있는 작업을 공식화하기 위해 Task Agent를 사용해 보세요. 마이그레이션 단계별로 독립적인 하위 에이전트를 생성하여 보고하기 전에 전체 스위트에 대해 스스로 검증하게 하세요. 지오메트리 작업의 경우, Claude에게 사전에 적대적 토폴로지 어설션(매니폴드성, 와인딩, 겹침 없음)을 작성하도록 요청하여 수정 사항이 약한 테스트가 아닌 실제 오라클을 기준으로 판단되도록 하세요. 검증/병합 단계 이전에 활성 워크트리와 에디터 상태를 확인하는 훅을 사용하면 가장 치명적인 잘못된 확신으로 인한 실패를 제거할 수 있습니다. 시도해 볼 기능 →
야심 찬 워크플로우: 모델이 개선됨에 따라, 당신의 단계별 마이그레이션은 5~10개의 독립적인 워크트리 리팩토링을 병렬로 수행하는 코디네이터 에이전트와 자연스럽게 어울릴 것입니다. 각 에이전트는 스스로 검증하고 성공했을 때만 병합하여 며칠 걸릴 캠페인을 병렬 버스트로 압축할 수 있습니다. 메시 세션은 완전히 자율적인 테스트 주도 수렴 루프를 실행하여 퇴보하는 변경 사항을 되돌리고, 지오메트리가 증명 가능하게 수렴하거나 구조적 재설계가 차단 요소로 발견될 때까지 반복할 수 있습니다. 성능 작업은 프로파일러 기반의 자율 에이전트로 전환하여 순위가 매겨진 증거 기반의 근본 원인 가설을 생성하고, 검증되고 재현 가능한 성과만 커밋하여 시간을 낭비하게 만드는 잘못된 가설을 건너뛸 수 있습니다. 앞으로의 전망 →
다른 사람들에게는 뭐라고 하는지 궁금하네요.

