🤖 09. /insights

/insights는 Claude Code 세션 패턴을 분석해, 작업 흐름의 마찰 지점을 찾고 개선 방향을 제시하는 명령입니다. 핵심은 리포트를 읽는 게 아니라 리포트에서 한 가지 규칙을 실제 운영으로 고정하는 데 있습니다.

flowchart LR
  A[/insights 실행] --> B[마찰지점 1개 선택]
  B --> C[개선 규칙 1개 고정]
  C --> D[1주 적용]
  D --> E[/insights 재확인]

🧠 칠판 치트시트

• 인사이트는 감상용이 아니라 운영 규칙 생성용
• 한 번에 많이 바꾸지 말고 1개 규칙만 고정
• 다음 측정 시점까지 추적 지표를 같이 정한다

1) 공식 명령 맥락

Interactive mode 공식 문서의 built-in commands에 /insights가 포함되어 있습니다.

참고: https://code.claude.com/docs/en/interactive-mode

실행

/insights

함께 보면 좋은 명령:

/cost
/memory

2) 리포트에서 꼭 봐야 할 4가지

공식 설명 기준으로 /insights는 아래 축을 중심으로 리포트를 만듭니다.

1. 프로젝트 활동 영역(project areas)
2. 상호작용 패턴(interaction patterns)
3. 마찰 지점(friction points)
4. 개선 제안(actionable improvements)

실무에서는 이 4축을 팀 주간회고 템플릿과 맞물리게 두는 게 효과적입니다.

3) 인사이트를 운영 규칙으로 바꾸는 방법

나쁜 방식

• 리포트 읽고 “좋은 말이네”로 종료

좋은 방식

• 마찰 1개 선택
• 운영 규칙 1개로 문서화
• 1주 적용 후 /insights 재실행

4) 규칙 고정 템플릿

# Insight Action Rule
- 발견된 마찰: 컨텍스트 전환 시 재설명 반복
- 새 규칙: 작업 전환 시 /clear 후 새 목표 1문장 선언
- 측정 지표: 재질문 횟수, 완료까지 턴 수
- 재점검일: 7일 후

5) 미니 사례 2개

사례 A: 재질문 반복 감소

인사이트에서 “요구사항 재확인 턴이 길다”는 신호를 확인하고, 시작 프롬프트 템플릿을 고정했습니다. 이후 초기 정렬 속도가 개선됐습니다.

사례 B: 비용 누수 개선

/cost와 함께 보니 긴 세션 유지가 누수 원인이었습니다. 작업 단위 종료마다 /clear 규칙을 넣어 평균 세션 비용이 안정화됐습니다.

6) 15분 도입 루틴

1. 5분: /insights 실행 후 마찰 1개 선정
2. 5분: 규칙 1개 작성(팀 문서 또는 CLAUDE.md)
3. 5분: 측정 지표 2개 정의

완료 기준:

• 개선 규칙이 문서에 남아 있고, 다음 측정일이 지정되어 있다

운영 체크리스트

• /insights 결과를 실행 항목으로 변환했는가?
• 한 번에 1개 규칙만 적용했는가?
• /cost와 함께 교차 점검했는가?

다음 읽기

• 🤖 08. 비용운영
• 🤖 03. 운영스택
• 🤖 00. 개요

생성형 AI 활용 고지

이 문서는 Claude Code 공식 문서를 바탕으로 생성형 AI를 활용해 정리했으며, 최종 공개 전 사람이 검토·보정했습니다.