r/ClaudeCode•약 1개월 전•18•6
AI 에이전트가 레거시 코드를 패치하는 대신 삭제하도록 강제하는 스킬 파일을 찾음
found a skill file that forces my ai agent to delete legacy code instead of patching it
핵심 요약
AI 에이전트의 불필요한 레거시 코드 유지 습관을 고치기 위해, 리팩토링을 강제하는 'Zero Tech Debt' 스킬 파일을 공유함.
- 기술 부채 해결 — AI 에이전트가 레거시 코드를 삭제하고 깔끔하게 리팩토링하도록 유도함.
- 스킬 파일 활용 — 'Zero Tech Debt' 설정을 통해 코드베이스의 가독성과 효율성을 높임.
- 사용법 공유 — 버그 수정이나 기능 구현 직후 에이전트의 컨텍스트가 유지될 때 실행을 권장함.
- 설치 방법 — npx skills add jnsahaj/skills 명령어로 간편하게 추가 가능함.
내 코드베이스에 몇 주째 돌려보고 있는데, 돌릴 때마다 가독성이 미친 듯이 올라감. 전체 내용은 이거임.
에이전트 기본 설정은 이따위임:
- 전면 재설계 대신 패치만 함
- 아무도 안 쓰는 레거시 코드를 "호환성" 핑계로 남겨둠
- 파일마다 코드 중복시킴
- 변수 이름 짓는 거 귀찮아함
이거 매번 일일이 수정해줘야 함.
언제 돌려야 함?
버그 고치거나 기능 배포하자마자, 에이전트가 문맥 다 파악하고 있을 때 바로 돌려야 함. 꾸준히 하면 기술 부채 쌓일 일 없음.
---
name: zero-tech-debt
description: Rework a change as if the intended UX and architecture existed from day one, deleting compatibility cruft and accidental complexity.
user-invocable: true
---
# Zero Tech Debt
Rework the change from the intended end state, not from the historical path that produced the current patch.
## Steps
1. State the intended end state in one or two sentences.
2. Search for real callers before preserving compatibility.
If a mode, prop, wrapper, route alias, or fallback has no current caller, delete it.
3. Reshape around the final product surface.
Prefer one clear component or flow over mode flags. Split only when it creates an obvious boundary such as state, layout, controls, or domain commands.
4. Move shared rules to one place.
Feature flags, permissions, route gating, URL state, and command naming should not be duplicated across pages or hidden in view components.
5. Verify the intended flow.
Test the new behavior and any deleted assumptions that affect navigation, permissions, or persisted state.
## Rules
- Optimize for the code that should exist, not the smallest diff from the old shape.
- Delete dead compatibility paths instead of making them better.
- Do not invent a generic framework for one feature.
- Keep the refactor scoped to what makes the final shape coherent.
- Prefer names that describe product intent over implementation history.
설치:
npx skills add jnsahaj/skills
더 자세한 내용은 여기서 확인: https://reetlab.substack.com/p/the-zero-tech-debt-skill
