🚀 Resonance™ for Claude Code

🚀 Resonance™ for Claude Code

**⚠️ 중요 업데이트 (2025년 1월 8일)**: 버전 1.4.0 출시! 커맨드 구조가 크게 개선되었습니다. `npm update -g claude-resonance`로 업데이트하거나 `npx claude-resonance`로 최신 버전을 사용하세요.

Auto-Compact로 컨텍스트가 날아갔나요? 끝없이 버그 수정 중인가요? **체계적인 Resonance™ 워크플로우로 해결하세요.**

🔥 우리 모두가 겪는 문제

Claude Code에서 Plan → Act 모드 사용 중 이런 문제들이 있었나요?

• 💔 20k 컨텍스트 윈도우: Auto-Compact로 최초 설계 내용 중 일부가 유실되어 코드 퀄리티가 떨어짐
• 🔄 테스트-수정 루프: AI 코드 받고 → 테스트 → 에러 → 수정 요청 → 반복...
• 🔍 작업 기록 없음: 이전 작업 기록이 채팅에만 묻혀 있음
• 🤖 AI의 추측: 니즈 이해 없이 코드만 던져서 계속 수정 요청

💡 AI가 다르게 작동한다면?

나: "API 구현해줘"
AI: "500줄 코드 여기있어요!"
나: [테스트해봄] "에러 나는데..."
AI: "아 그거 수정했어요!"
나: [또 테스트] "이번엔 다른 에러..."
AI: "이것도 고쳤어요!"
나: [또 테스트] "또 안 돼..."
   (무한 루프...)

나: "결제 API 구현해줘"
Opus: "실제 돈이 오가는 거니까 신중해야 해요.
같은 결제가 두 번 처리되면 어떻게 할 거예요?"
나: "어... 그런 경우가 있나?"
Opus: "네트워크 오류로 재시도할 때 자주 발생해요.
또 환불이나 부분 취소는요?"

[충분한 정보 수집 후...]

Opus: "좋아, 이제 완전히 이해했어!
'ultrathink'라고 입력하면 상세 설계 들어갈게."
나: "ultrathink"

[Phase 2: 깊은 분석...]

Opus: "분석 완료! 이렇게 설계했어:

🧪 테스트 시나리오 (5개)
1. 정상 결제 플로우
2. 중복 요청 방지 (idempotency key)
3. 네트워크 타임아웃 처리
4. 부분 환불 검증
5. Webhook 실패 재시도

🏗️ 구현 전략
- PaymentService 인터페이스로 추상화
- DB 트랜잭션으로 일관성 보장
- 에러 로깅 및 모니터링

계획을 cycles/2025-07-08/1430-payment-api-plan.md에 저장했어!"

📚 Resonance 이해하기

Resonance 철학과 기존 AI 코딩과의 근본적인 차이점을 더 깊이 이해하려면 [철학 문서](./PHILOSOPHY.md)를 참고하세요.

🔄 근본적인 변화

기존 AI 코딩:                    AI TDD 워크플로우:

┌─────────────────┐              ┌─────────────────┐
│ 나: "X 만들어줘"   │              │ 나: "X 만들어줘"   │
└────────┬────────┘              └────────┬────────┘
         │                                │
         ▼                                ▼
┌─────────────────┐              ┌─────────────────┐
│ AI: 코드 여기요    │              │ Opus: 먼저       │
│   (테스트 없음)    │              │ 이해할게요...      │
└────────┬────────┘              │ - X가 뭐예요?     │
         │                       │ - 엣지케이스는?    │
         ▼                       │ - 제약사항은?      │
┌─────────────────┐              └────────┬────────┘
│ 나: 테스트해봄     │                       │
│ "에러 나네..."    │                       ▼
└────────┬────────┘              ┌─────────────────┐
         │                       │ 나: [답변]        │