가드 스킬

가드 스킬은 AI 코딩 에이전트가 작업을 마친 뒤 그 변경분(diff)에 한 번 더 돌리는 2차 검증용 스킬로, 겉으로는 그럴듯하지만 허점이 있는 AI 코드·테스트·문서를 커밋·머지 직전에 걸러낼 때 쓴다. 가드마다 맡는 영역이 정해져 있어서 무엇을 바꿨는지에 따라 골라 부른다.

AI가 반복하는 실수만 노린다

AI 에이전트는 아무것도 검증하지 못하는 테스트를 쓰거나, 사실상 같은 테스트를 중복으로 찍어내거나, 실제 코드와 어긋나는 문서를 채워 넣곤 한다. 가드 스킬은 이렇게 AI 결과물이 되풀이해서 빠지는 실패 패턴만 좁게 겨냥한다.

만드는 쪽과 검사하는 쪽을 나눈다

코드를 짠 에이전트가 자기 결과를 스스로 평가하면 같은 맹점을 그대로 통과시키기 쉽다. 그래서 가드는 만드는 일과 떨어져서 별도의 검사 기준만 들고 diff를 다시 들여다본다.

커밋·머지 직전에 직접 부른다

가드 스킬은 Claude Code의 스킬(Skill) 기능 위에서 동작한다. 평소처럼 에이전트에게 작업을 끝내게 한 뒤, 마지막에 사람이 "이 diff에 test-guard 돌려줘"처럼 직접 부른다. 자동 훅으로 매번 강제하기보다 발표·커밋·머지 직전이라는 길목에서만 검사를 끼워 넣는 것이 권장 방식이다.

통과해도 무결을 보장하지는 않는다

가드는 만능 린터가 아니라 AI 코드 특유의 함정만 겨냥한 도구라서, 일반 정적 분석이나 사람의 코드 리뷰를 대신하지 않는다. 가드 자체도 AI가 판단하므로, 흔한 함정을 한 번 더 걸러주는 안전망 정도로 보는 편이 맞다.

에이전트 작업의 마지막 관문으로 쓴다

가장 흔한 방식은 코딩 에이전트가 일을 끝낸 직후, 사람이 결과를 받아들이기 전에 바꾼 내용에 맞는 가드를 한 번 돌리는 것이다. 가드가 짚은 문제를 에이전트에게 다시 고치게 한 뒤 커밋하거나 리뷰를 요청한다.