AI가 생성한 코드·테스트·문서가 흔히 빠지는 실패 패턴을, 작업이 끝난 변경분에 한 번 더 돌려 잡아내는 2차 품질 검증용 스킬.
AI 코딩 에이전트는 그럴듯해 보이지만 실제로는 허점이 있는 결과물을 자주 만든다. 아무것도 검증하지 못하는 테스트를 쓰거나, 사실상 같은 테스트를 중복으로 찍어내거나, 실제 코드와 어긋나는 문서를 채워 넣는 식이다. 가드 스킬(Guard Skills)은 이렇게 AI 결과물이 반복적으로 빠지는 실패 모드를 겨냥해, 에이전트가 작업을 마친 뒤 그 변경분(diff)에 한 번 더 돌리는 2차 검증용 스킬이다.
핵심은 "만드는 일"과 "검사하는 일"을 분리한다는 데 있다. 코드를 짠 에이전트가 자기 결과를 스스로 평가하면 같은 맹점을 그대로 통과시키기 쉽다. 그래서 가드 스킬은 별도의 검사 기준만 들고 diff를 다시 들여다본다.
에이전트에게 일단 작업을 끝내게 한 뒤, 결과를 발표하거나 커밋·머지하기 직전에 변경분에 가드를 건다. 테스트를 새로 짰다면 $test-guard를 그 테스트에 돌려서 목(mock) 남용, 구현 세부사항에 매달리는 단언, 사실상 아무것도 잡지 못하는 테스트가 섞여 있는지 점검한다. README를 고쳤다면 $docs-guard로 문서가 실제 동작과 어긋나지 않는지 본다.
가드마다 담당 영역이 정해져 있다. clean-code-guard는 일반 코드 품질을, test-guard는 테스트를, docs-guard는 문서를 맡는다. WordPress·WooCommerce처럼 특정 프레임워크 변경에만 거는 전용 가드(wp-guard, woo-guard)도 따로 있다.
가드 스킬은 Claude Code의 스킬(Skill) 메커니즘 위에 구현된다. 그래서 평소처럼 에이전트가 코드를 생성하게 두고, 마지막에 사람이 "이 diff에 test-guard 돌려줘"라고 부르는 식으로 사람이 게이트를 통과시키는 시점을 직접 정한다. 자동 훅으로 매번 강제하기보다, 발표·커밋·머지 직전이라는 명확한 길목에서만 검사를 끼워 넣는 것이 권장 사용법이다.
가드는 만능 린터가 아니다. AI 코드 특유의 실패 모드를 좁게 겨냥한 도구라, 일반적인 정적 분석이나 사람 코드 리뷰를 대체하지는 않는다. 또한 가드 자체도 AI가 판단하므로, 통과했다고 무결을 보장하지는 않는다 — 어디까지나 "흔한 함정을 한 번 더 걸러주는" 안전망으로 보는 편이 맞다.