AI 에이전트가 쓰레기를 작성하게 두지 마세요: 지금 당장 설치해야 할 5가지 기술

Claude Code, Cursor, Opencode, Antigravity 또는 Gemini와 같은 AI 코딩 에이전트를 그대로(out of the box) 사용해 보셨다면, 아마 어떤 패턴을 발견하셨을 것입니다. 때로는 훌륭한 코드를 작성하기도 하지만, 다른 때에는 문제에 무작정 뛰어들어 터무니없는 가정을 하고, 풀어내는 데 몇 시간이 걸리는 500줄의 비대하고 과하게 설계된 스파게티 코드(spaghetti code)를 뱉어내기도 합니다.

AI 에이전트는 믿을 수 없을 정도로 강력하지만, 규율(discipline), 안목(taste), 그리고 구조화된 방법론(structured methodology)이 부족합니다. 마치 에너지 드링크를 세 잔이나 마신 열정적인 주니어 개발자처럼 행동합니다.

이를 해결하려면 AI의 행동 방식을 근본적으로 변화시키는 조합 가능한 지침(composable instructions), 워크플로우(workflows), 그리고 가드레일(guardrails)인 **에이전트 기술(agent skills)**이 필요합니다.

혼란스러운 AI 어시스턴트를 규율 있는 전문 엔지니어링 팀으로 바꾸기 위해 지금 당장 설치해야 할 다섯 가지 필수 에이전트 기술을 소개합니다.

1. Superpowers

Repository: obra/superpowers

기능: Superpowers는 에이전트를 위한 완전한 소프트웨어 개발 방법론(software development methodology) 역할을 합니다. 코드를 바로 작성하는 대신, AI가 한 걸음 물러나 사용자가 실제로 원하는 것이 무엇인지 인터뷰하고 이해하기 쉬운 사양(spec)을 작성하도록 강제합니다. 사용자가 사양을 승인하면, 구현 계획(테스트 주도 개발 (Test-Driven Development) 강조)을 생성하고 하위 에이전트(sub-agents)를 가동하여 작업을 자율적으로 수행합니다.

필수적인 이유: 시스템이 없으면 AI 에이전트는 대규모 프로젝트의 복잡함 속에서 길을 잃습니다. Superpowers는 혼란에 질서를 부여합니다. 이것이 필요한 이유는 AI가 사용자의 의도를 추측하는 것을 방지하고, 긴 자율 코딩 세션 중에도 경로를 유지하도록 보장하기 때문입니다.

2. Agency Agents

Repository: msitarzewski/agency-agents

기능: 단일하고 일반적인 AI 어시스턴트에 의존하는 대신, Agency Agents는 고도로 전문화되고 개성이 부여된 AI "직원" 명단을 제공합니다. Core Web Vitals에 집중하는 프론트엔드 개발자 (Frontend Developer), 사고 대응 커맨더 (Incident Response Commander), 또는 기술적 SEO 전문가 (technical SEO Specialist)가 필요하든 간에, 이 리포지토리는 특정 역할에 대해 검증된 워크플로우 (workflows)를 사용할 수 있게 해줍니다.

필수적인 이유: 범용 프롬프트 (General-purpose prompts)는 일반적인 결과만을 만들어냅니다. Agency에서 특정 에이전트를 로드함으로써, AI가 해당 분야의 시니어 전문가가 가진 깊은 전문 지식과 뚜렷한 결과물을 채택하도록 강제할 수 있습니다. 일반적인 코딩 어시스턴트보다 도메인 특화된 전문 지식이 필요할 때 이를 사용하세요.

3. Karpathy에게 영감을 받은 기술 (Karpathy-Inspired Skills)

리포지토리: multica-ai/andrej-karpathy-skills

기능: AI 연구자 Andrej Karpathy가 관찰한 LLM 코딩의 함정에서 유래된 이 기술은 네 가지 엄격한 원칙을 강제합니다: 코딩 전 생각하기 (Think Before Coding), 단순성 우선 (Simplicity First), 정밀한 변경 (Surgical Changes), 그리고 목표 중심 실행 (Goal-Driven Execution). 이는 AI가 가정을 명시적으로 기술하고, 절대적으로 필요한 최소한의 코드만을 작성하며, 관련 없는 파일은 건드리지 않고 스스로의 실수를 정리하도록 요구합니다.

필수적인 이유: AI 모델들은 추상화를 과도하게 복잡하게 만들고, 이해하지 못하는 코드를 조용히 변경하는 것으로 악명이 높습니다. 단순한 50줄짜리 수정을 1,000줄짜리 재앙으로 과잉 설계 (over-engineer)하려고 할 때마다 AI의 손등을 때리는 엄격한 테크 리드 (tech lead) 역할을 수행하기 위해 이 기술을 반드시 설치해야 합니다.

4. Addy Osmani의 에이전트 기술 (Addy Osmani's Agent Skills)

리포지토리: addyosmani/agent-skills

기능: Chrome 엔지니어링 리더인 Addy Osmani가 구축한 이 도구는 간단한 슬래시 명령어(예: /spec, /plan, /build, /test)로 실행되는 프로덕션급 엔지니어링 워크플로우(Engineering Workflows) 모음입니다. 시니어 엔지니어들이 사용하는 품질 게이트(Quality Gates)와 베스트 프랙티스(Best Practices)를 인코딩하여, AI가 검증되지 않은 채 한 번에 모든 작업을 처리하는 대신 단계적으로 자신의 작업을 검증하도록 강제합니다.

필수적인 이유: 엔터프라이즈급 코드 품질을 원한다면 이것이 반드시 필요합니다. 에이전트가 테스트나 코드 리뷰(Code Review)를 건너뛰지 않도록 보장합니다. AI로 구축하는 모든 기능에 구조화되고 예측 가능한 라이프사이클 관리(Lifecycle Management)를 도입하기 위해 이를 사용해야 합니다.

5. Taste Skill

리포지토리: Leonxlnx/taste-skill

기능: "안티 슬롭 프론트엔드 프레임워크(Anti-Slop Frontend Framework)"로 불리는 이 스킬은 AI가 구축한 인터페이스의 시각적 결과물을 업그레이드합니다. 2018년의 일반적인 대시보드처럼 보이는 기본 보일러플레이트(Boilerplate) UI 대신, Taste Skill은 에이전트가 프리미엄 레이아웃 패턴, 강력한 타이포그래피(Typography), 적절한 모션(Motion), 그리고 올바른 간격(Spacing)을 사용하도록 강제합니다.

필수적인 이유: AI는 기본적으로 평범한 디자인을 선택합니다. 사용자 대상 애플리케이션을 구축하고 있다면, Taste Skill을 설치하는 것은 저렴한 프로토타입처럼 보이는 앱과 세심하게 제작된 프리미엄 제품처럼 느껴지는 앱 사이의 차이를 만들어냅니다. CSS 패딩(Padding)과 폰트 두께(Font Weights)를 끊임없이 미세 관리할 필요 없이, 프론트엔드 코드를 즉시 격상시키기 위해 이를 사용하세요.

결론

사양서(Spec), 계획(Plan), 또는 코드 리뷰(Code Review) 없이 주니어 엔지니어가 프로덕션에 바로 커밋(Commit)하도록 내버려 두지는 않을 것입니다. AI가 그렇게 하도록 방치하지 마세요. 이러한 스킬들을 설치함으로써, 일관되고 고품질의 결과물을 얻기 위해 필요한 가드레일(Guardrails)을 제공할 수 있습니다. 스킬을 설치하고, 기준을 설정한 다음, 에이전트가 힘든 작업을 수행하게 하세요.