코드베이스 정리(언탱글)

무엇을 해주나

• 코드베이스 전체를 "이 조각들은 같이 바뀌어야 하는가?" 라는 단 하나의 질문으로 점검합니다.
• 문제를 세 가지로 분류해 전수 목록화합니다: 숨은 연결(같이 바뀌어야 하는데 코드가 그걸 드러내지 않음), 불필요한 연결(서로 다른 이유로 바뀌는데 묶여 있음), 잉여(스스로 바뀔 이유가 없는 래퍼·죽은 코드·추측성 확장점).
• if 한 줄, 특정 호출자 전용 파라미터, 삼킨 예외, retry/sleep, 비활성 테스트 같은 특수 케이스를 모두 기록하고, 이를 설계가 놓친 요구사항의 단서로 사용합니다.
• 개별 땜질이 아니라 여러 문제를 한 번에 없애는 단 하나의 수정을 찾아 재설계하고, 결정 로그(문제 → 수정) 형태로 남깁니다.
• 선택 시 주석 정리와 테스트 정리(구현을 그대로 따라 하는 테스트, 절대 실패할 수 없는 테스트 제거)까지 수행합니다.
• 작업 후 서브에이전트로 재검사하며 "고칠 가치가 있는 게 남지 않을 때까지" 반복합니다.

이런 분께 추천

• 오래 방치돼 손대기 두려운 레거시 프로젝트를 구조부터 뜯어고치고 싶은 개발자
• AI 에이전트가 코드를 자주 잘못 건드려서, 에이전트 친화적인 구조로 정비하고 싶은 팀
• 기능 하나 추가할 때마다 5~6군데를 동시에 고쳐야 하는 상황에 지친 분

활용 예시

• 결제 모듈 분리: checkout과 refunds가 Stripe를 직접 참조하고 곳곳에 if (provider === "paypal")가 흩어져 있을 때 → PaymentProvider 인터페이스 하나로 통합.
• 액션 중복 제거: 툴바·메뉴·단축키·커맨드 팔레트·실행취소가 각자 액션 목록을 들고 있을 때 → 이름·핸들러·undo를 가진 단일 커맨드 목록으로 통합.
• 타이밍 핵 제거: 다이얼로그가 100ms sleep 후 포커스를 되돌리고 전역 플래그로 예외 처리하던 코드를 공통 Dialog의 포커스 복원 규칙으로 대체.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/aiskillstore/marketplace/HEAD/pending/caldoai/untangle-codebase/SKILL.md

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

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