아키텍처 최적화 여정

무엇을 해주나

이미 돌아가고 있지만 느리고 구조가 엉킨 코드베이스를 아키텍처 · 코드 품질 · 성능 세 축에서 동시에 개선합니다.

• 8단계 여정: ①행동 고정 및 성능 측정(레거시 코드) → ②의존성 경계 복원(클린 아키텍처) → ③모듈 심화 → ④핫패스 리팩터링 → ⑤측정된 병목 공략(시스템 디자인) → ⑥데이터 계층 수정(쿼리·인덱스·격리수준) → ⑦장애 시 지연 대응(타임아웃·서킷브레이커) → ⑧CI 게이트로 성능 예산 고정
• 핵심 원칙: 측정하지 않은 곳은 최적화하지 않고, 테스트로 고정되지 않은 코드는 구조를 바꾸지 않습니다. 수치가 개선되지 않은 변경은 유지하지 않고 되돌립니다.
• 재개 가능: 모든 진행 상황이 docs/ARCHITECTURE-OPTIMIZATION-PLAN.md, PERFORMANCE.md, ARCHITECTURE.md 등에 기록되어 세션이 끊겨도 이어서 진행합니다.
• 매 결정마다 질문: 예산 수치, 캐시 무효화 규칙, 인덱스 추가 여부 등을 임의로 정하지 않고 사용자에게 선택지와 추천안을 제시합니다.

이런 분께 추천

• "동작은 하는데 점점 느려지고 손대기 무섭다"는 상용 서비스를 운영 중인 백엔드/풀스택 개발자
• p95 지연, 느린 쿼리, 치솟는 인프라 비용을 근거 기반으로 해결하고 싶은 팀 리드
• 리팩터링 계획과 성능 개선 근거를 문서로 남겨야 하는 테크 리드·아키텍트

활용 예시

1. 결제 API가 느릴 때: "체크아웃 p95를 500ms 아래로 낮추고 싶다" → Phase 1에서 특성화 테스트와 프로파일 베이스라인을 잡고, Phase 5~6에서 N+1 쿼리와 누락 인덱스를 전후 수치와 함께 개선.
2. 경계가 무너진 모놀리스: 비즈니스 로직이 ORM을 직접 import하는 상황 → Phase 2에서 의존성 그래프를 그려 위반 목록을 표로 만들고, 핫패스 유스케이스를 프레임워크 없이 추출.
3. 외부 API 하나가 죽으면 전체가 멈출 때: Phase 7에서 모든 아웃바운드 호출에 타임아웃·서킷브레이커·벌크헤드를 배치하고 RED 지표 알림을 설계.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/wondelai/skills/HEAD/architecture-optimization/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 wondelai/skills 의 architecture-optimization 폴더를 내 ~/.claude/skills/architecture-optimization/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.