AI가 플러그인 80%를 작성했지만, 6개월 후 유지보수가 불가능했다.
발행: (2026년 6월 7일 PM 01:05 GMT+9)
3 분 소요
원문: Dev.to
출처: Dev.to
플러그인을 6개월 만에 다시 열었을 때 가장 먼저 눈에 띈 것은 동일한 날짜 포맷 로직이 세 곳에 흩어져 있었다는 점이다.
- 하나는 유틸리티 함수에,
- 하나는 클래스 메서드에,
- 하나는 템플릿 안에 인라인으로.
모두 조금씩 달랐다. 누군가 보고한 버그, 즉 가끔씩 표시가 어긋나는 현상은 세 복제본 중 가장 오래된 곳에서 비롯된 것이었다. 이를 고치려면 먼저 어느 복사본을 수정해야 하는지, 나머지 두 개도 손봐야 하는지 파악해야 했다. 버그 자체는 어렵지 않았다. 내 코드를 이해하는 것이 어려웠다. 나는 AI에게 전체의 약 80%를 빠르게 작성하게 했고, 사양서는 전혀 쓰지 않았다.
나는 WordPress 플러그인을 만들고 대부분의 날 코딩 에이전트를 사용한다. 그래서 누구에게도 에이전트 사용을 중단하라고 말하려는 것이 아니다. 여기서는 속도를 유지하면서도 결과물을 유지보수할 수 있는 방법을 이야기한다. 아래는 실제로 도움이 된 순서대로 정리한 내용이다. 상위 두 가지만으로도 미래의 나를 훨씬 덜 고통스럽게 만든다.
설정 (맥락을 위해)
버전은 빠르게 바뀌니 아래 이름들은 내가 확인했을 때 기준이며, 여러분의 환경에서 다시 확인하세요.
- Claude Code (
claude --version)와 Codex CLI (codex --version), 매일 사용 - PHP 8.3 / WordPress, 대상은 플러그인과 테마
- 지속적인 지시 파일: Claude Code용
CLAUDE.md, Codex CLI용AGENTS.md
이것이 완벽한 워크플로우는 아니다. 한 번 크게 실수한 사람이 나중에 정리한 것이다.
왜 6개월 뒤에 읽기 어려워지는가
수정하기 전 진단을 세 문장으로 요약한다. 문제는 속도가 아니다. 속도가 조용히 없애버리는 것이 있다.