맷 포콕(Matt Pocock)
최근 AI 코딩 도구(Cursor, Claude Code, GitHub Copilot 등)를 사용하면서 이런 피로감을 느껴보신 적이 있으신가요?
"대충 그럴싸한 코드를 빠르게 짜주긴 하는데, 결국 디버깅에 시간을 다 날리거나 아키텍처가 엉망진창이 된다..."
이러한 현상을 업계에서는 '바이브 코딩(Vibe Coding)'이라고 부릅니다. 감에만 의존해 코딩을 맡기다 보니 결국 프로젝트 후반부에 유지보수 비용이 폭발하는 것이죠.
유명 기술 교육자이자 Total TypeScript의 창시자인 맷 포콕(Matt Pocock)은 이 문제를 해결하기 위해 AI 에이전트 전용 마이크로 프롬프트 저장소인 mattpocock/skills를 공개했습니다. 이 글에서는 그의 설계 철학과 핵심 스킬 분석, 그리고 실제 현업에서 이를 백분 활용하는 워크플로우를 정리해 드립니다.
맷 포콕이 29개 스킬에 예외 없이 적용한 프롬프트 다이어트 공식입니다.
- 트리거 (Trigger): 스킬을 누가 호출할지(사용자 vs 모델) 정의하고 컨텍스트 비용을 제어합니다.
- 구조 (Structure): 절차는 최소화하고 참고 문서는 별도로 분리하는 '2계층 아키텍처'를 씁니다.
- 유도 (Guidance): Vertical slice 같은 고전 소프트웨어 공학 용어를 통해 AI의 고품질 행동을 유도합니다.
- 가지치기 (Pruning): 삭제 테스트를 통해 없어도 결과가 같은 문장은 과감히 지워 예측 가능성을 높입니다.
1. 저장소 핵심 스킬 5가지 정밀 분석
맷 포콕의 전체 스킬 중 현업에서 만족도가 가장 높고 파괴력이 강한 5가지 시그니처 스킬의 세부 작동 방식입니다.
AI 에이전트에게 현재 프로젝트의 개발 규칙(Conventions)을 미리 동기화합니다. 일회성 설정 스킬로, 사용하는 이슈 트래커 종류, 티켓 분류용 라벨 시스템, 아키텍처 의사결정 기록(ADR)의 저장 경로 등을 에이전트가 질문하게 만든 뒤 .claude/ 등에 기록해 둡니다. AI가 마음대로 엉뚱한 경로에 파일을 생성하는 등의 환각(Hallucination)을 막아줍니다.
개발을 시작하기 전, 계획의 설계적 결함을 끝까지 파헤칩니다. 질문은 한 번에 딱 하나씩만 던져 인간이 깊게 생각할 여유를 주며, AI가 코드베이스를 직접 탐색한 결과를 바탕으로 2~5개의 구체적인 대안을 제안합니다. 사용자는 단순 선택만으로 완벽한 설계를 합의할 수 있습니다.
대충 코드부터 짜놓고 테스트를 나중에 끼워 맞추는 안티 패턴을 원천 차단합니다. 여러 개의 테스트를 한 번에 작성하는 대신, "실패하는 테스트 1개 작성 -> 통과할 만큼만 최소 구현 -> 리팩토링"이라는 수직적 슬라이싱(Vertical Slicing)을 에이전트가 순서대로 밟아가도록 제어합니다.
에러 로그 한 줄만 보고 무작정 코드를 헤집어 버그를 더 키우는 불상사를 막습니다. 재현(Reproduce) → 최소화(Minimize) → 가설(Hypothesize) → 계측(Instrument) → 수정(Fix)이라는 고전적인 디버깅 5단계를 무조건 순서대로 거쳐 논리적으로 버그의 근본 원인을 수정하도록 강제합니다.
AI 특유의 미사여구, 무의미한 인사말, 장황한 설명 등을 완전히 제거합니다. 관사, 접속사, 부사를 생략하고 화살표(->)와 단어 위주로 컴팩트하게 답합니다. 이를 통해 에이전트의 답변 대기 시간이 줄어들고 소중한 토큰 비용을 최대 75%까지 절약할 수 있습니다.
2. 실무 적용을 위한 이상적인 AI 개발 파이프라인
이 마이크로 스킬들은 단독으로 쓰기보다, 작업 흐름에 맞춰 유기적으로 엮을 때 시너지가 납니다. 아래의 순서대로 워크플로우를 세팅해 보시길 권장합니다.
/setup을 통해 프로젝트 규칙을 연동한 뒤, /grill-with-docs를 통해 현재의 전체적인 구현 방향성과 레거시 코드를 검증합니다. 이때 합의된 의사결정 사항들은 자동으로 CONTEXT.md나 ADR 문서에 기록하게 합니다.
의사결정이 완료되면 이를 바탕으로 명확한 구현 사양서(PRD / Specification)를 한 페이지 분량으로 컴파일하도록 지시합니다. 이 파일은 구현 단계에서 에이전트가 지켜야 할 단 하나의 기준점(Single Source of Truth)이 됩니다.
작성된 사양서(Spec)를 통째로 한 번에 빌드하도록 두지 말고, 즉각적으로 배포 가능한 아주 얇은 두께의 작업 단위(Tracer-bullet)로 잘게 쪼개어 파일이나 GitHub Issue에 직접 티켓으로 생성하게 합니다.
쪼개진 티켓 단위마다 /tdd 스킬을 활성화하여 철저히 테스트 주도 개발 루프 속에서 안전하고 견고한 기능 구현을 완수해 냅니다. 이 반복 과정에서는 불필요한 토큰 낭비를 줄이기 위해 /caveman 모드를 병행하는 것이 좋습니다.
3. 우리 팀만을 위한 커스텀 스킬 구축 가이드
맷 포콕의 저장소를 단순히 가져다 쓰는 데서 그치지 않고, 우리 팀의 "시니어 개발자의 일하는 방식"을 템플릿화하는 것이 궁극적인 목표가 되어야 합니다. 커스텀 스킬을 직접 설계할 때 유용한 3가지 원칙입니다.
- 모호한 제안 대신 '단호한 규칙'을 사용하세요: "타입스크립트 타입을 엄격하게 정의하면 좋습니다" 대신 "절대 any 타입을 허용하지 마라. 발견 즉시 컴파일 단계를 중단하라"와 같이 모델을 완벽히 통제해야 효과가 있습니다.
- 우리 팀만의 고유 도메인 용어(Jargon)를 정의하세요: 신입 개발자가 헷갈리기 쉬운 특이한 모듈 구조나 사내 고유 API 설계 방식을 스킬의 '레퍼런스' 영역에 녹여냅니다.
- 지시(Instruction)와 참고(Reference)를 철저히 쪼개세요: 매번 읽어야 하는 주 지시 파일은 30줄 내외로 아주 가볍게 유지하고, 수십 페이지짜리 API 가이드나 라이브러리 공식 문서는 별도 텍스트 파일로 분리하여 필요할 때만 불러오게 만듭니다. (2계층 구조)
만약 터미널 에이전트를 사용 중이시라면 아래 명령어로 맷 포콕의 검증된 스킬 카탈로그를 로컬 프로젝트에 즉시 추가하여 테스트해 볼 수 있습니다.
npx skills@latest add mattpocock/skills
마무리하며
AI 에이전트는 결코 마술 도구가 아닙니다. 좋은 질문을 정교하게 던지고, 잘못된 경로로 가지 않도록 경계를 쳐주는 고전 소프트웨어 공학의 '설계 원칙'이 그대로 적용되는 도구일 뿐입니다. 맷 포콕의 영리한 마이크로 스킬들을 적용해 바이브 코딩에서 탈피하고, 더 안정적이고 예측 가능한 고품질 AI 페어 프로그래밍을 경험해 보세요!
댓글
댓글 쓰기