Technical Debt

improve-codebase-architecture는 코드베이스에서 아키텍처 마찰, 얕은 모듈, 더 깊게 다룰 수 있는 개선 지점을 찾는 데 도움을 줍니다. 리팩터링 검토, 테스트 용이성 개선, AI가 탐색하기 쉬운 설계 결정을 다룰 때 유용하며, 특히 `CONTEXT.md`와 `docs/adr/` 지침을 존중하는 방향으로 스킬을 적용하고 싶을 때 적합합니다.

deprecation-and-migration는 단계별 마이그레이션, 의존성 파악, 배포 시점, 공지 방식, 롤백 기준을 바탕으로 API, 기능, 시스템을 안전하게 종료하도록 팀의 계획 수립을 돕습니다.

extract 스킬은 팀이 반복되는 UI 패턴, 토큰, 컴포넌트를 찾아내고, 더 안전한 마이그레이션 경로를 고려해 기존 디자인 시스템으로 통합을 계획하거나 실제로 진행할 수 있도록 돕습니다.

request-refactor-plan은 사용자 인터뷰, repo 점검, 선택지 분석, 테스트 확인, 작은 커밋 단위 계획을 통해 막연한 리팩터링 아이디어를 범위가 명확한 GitHub issue로 구체화하도록 돕습니다.

migrate-to-shoehorn는 TypeScript 테스트 파일에서 안전하지 않은 `as`, `as unknown as` 캐스트를 @total-typescript/shoehorn의 `fromPartial()`와 `fromAny()`로 리팩터링할 때 유용한 스킬입니다. 테스트 전용 fixture 정리, 부분 데이터 처리, 더 안전한 negative test 마이그레이션에 적합합니다.

improve-codebase-architecture는 실제 리포지토리를 점검해 아키텍처상 마찰 지점을 찾아내고, 테스트 용이성·seam·유지보수성을 높일 수 있는 deep-module 리팩터링 후보를 제안하는 데 도움을 줍니다.

reducing-entropy 스킬은 코드베이스를 줄이는 데 초점을 둔 수동 전용 리팩터링 보조 도구입니다. 먼저 SKILL.md와 참조 mindset 최소 1개를 읽고, 삭제를 우선하며 더 단순한 최종 상태와 전체 코드량 감소를 지향하도록 의식적으로 사용하세요.

refactoring-specialist는 동작은 유지한 채 코드 구조, 가독성, 유지보수성을 개선하도록 돕는 코드 리팩터링 스킬입니다. 코드 스멜을 찾아내고, 작고 안전한 리팩터링을 적용하며, 테스트와 검증을 함께 고려할 수 있게 지원합니다.

moyu-ko는 변경을 최소화하고, 범위를 명확히 하며, 검토하기 쉽게 만드는 코드 편집 스킬입니다. 요청받은 파일만 편집하고, 가장 단순한 해결책을 우선하며, 범위가 불분명할 때는 먼저 묻도록 도와 과도한 설계를 피하게 합니다. 정밀한 diff, 집중된 버그 수정, 그리고 절제된 코드 편집을 위한 실용적인 moyu-ko 가이드가 필요할 때 사용하세요.

pua-en은 정체된 AI 작업을 구조화된 트러블슈팅, 더 강한 주도성, 명확한 트리거 규칙으로 에스컬레이션하는 GitHub 스킬입니다. 반복 실패, 소극적인 조사, 디버깅 막다른 길에 도달했을 때 사용하세요. `SKILL.md`를 확인하고 `tanweai/pua`에서 설치한 뒤, 일반적인 프롬프팅만으로는 부족한 코드, 설정, 배포, API, 리서치 작업에 적용할 수 있습니다.