2026. 05. 04.

AI가 만든 미로에 AI가 길을 잃는다 — Matt Pocock의 6가지 처방

#ai#coding#claude-code#software-engineering#fundamentals

Matt Pocock. 타입스크립트 커뮤니티에서는 "타입스크립트 그 사람"으로 통하는 분이다. Total TypeScript 강의로 유명하고, Vercel에서 디벨로퍼 어드보킷, XState 코어팀 출신.

근데 최근 1년, 이 분이 방향을 완전히 틀었다. AI 엔지니어링으로. AI Hero라는 플랫폼 만들고 Claude Code for Real Engineers 강의 운영 중.

이번 발표는 그 과정에서 정리한 결론이다. 한마디로:

타입스크립트로 유명해진 사람이 AI 엔지니어링으로 피보타하더니, 근데 알고 보니 옛날 펀더멘탈이 더 중요하더라.

일주일 만에 41만 뷰. 이유가 있다.

코드는 싸지 않다

요즘 AI 업계에 Specs-to-Code 운동이 있다. 스펙만 잘 쓰면 AI가 코드 다 짜준다. 문제 생기면 스펙만 고치고 컴파일러 다시 돌려라. 코드는 안 봐도 된다.

포콕이 직접 해봤다. 결과?

컴파일러를 돌릴 때마다 코드가 더 망가졌다.

프래그매틱 프로그래머에 나오는 소프트웨어 엔트로피 개념. 부분만 고치고 전체 설계를 안 보면 시스템은 점점 무너진다. Specs-to-Code가 정확히 그걸 하고 있었다.

6가지 함정과 처방

1. 의도가 안 맞으면 → 신문(Grill)해라

AI가 머릿속에 있던 것과 완전히 다른 걸 만든다. 프레더릭 브룩스의 디자인 컨셉 개념. 두 사람이 같이 만들 때 둘 사이에 떠다니는 "이걸 만들고 있다는 감각"이 있는데, 사람과 AI 사이에서는 절대 공유가 안 된다.

처방: "Grill Me" 스킬 (GitHub 별 13,000개)

이 계획의 모든 측면을 끝까지 신문해라. 우리가 같은 이해에 도달할 때까지.

이 한 줄 넣으면 AI가 40~100개 질문을 던진다. 포콕은 Claude Code 기본 플랜 모드보다 이게 낫다고 단언. 플랜 모드는 너무 빨리 결과물부터 만들려고 한다.

2. AI가 장황하면 → 공통 단어집을 만들어라

AI가 같은 걸 자꾸 다른 단어로 풀어 말한다. 도메인 전문가랑 일할 때 전문 용어가 안 맞으면 코드가 어긋나는 것과 똑같다.

처방: 유비쿼터스 랭귀지 (DDD에서 가져온 개념)

코드베이스를 스캔해서 용어를 추출하고 마크다운 사전을 만든다. 사람도 보고 AI도 보는 공통 단어집. 이걸 도입하고 나서 AI의 생각 방식이 덜 헤맨다고.

3. 안 돌아가면 → TDD로 속도를 제한해라

코드는 그럴듯한데 실행하면 터진다. LLM이 피드백 도구를 늦게 쓴다. 이미 망가진 다음에 타입체크를 한다.

처방: TDD. 옛날 방법인데 LLM한테 더 중요하다.

테스트를 먼저 쓰면 AI가 강제로 작은 단위로 움직인다. 프래그매틱 프로그래머의 오버러닝 헤드라이트 비유. 헤드라이트가 비추는 거리보다 빨리 달리면 사고 난다. 피드백의 속도가 곧 속도 제한.

4. AI가 자기 미로에 갇힌다 → 딥 모듈로 재구성해라

여기가 이 발표에서 가장 강력한 진단이다.

AI한테 그냥 코드 짜라고 하면 작은 모듈을 잔뜩 만든다. 디폴트가 샬로우 모듈. 기능은 적은데 인터페이스가 복잡한 미로 같은 구조.

다음번에 AI가 그 코드를 다시 읽으려고 하면, 자기가 만든 미로인데 자기가 길을 잃는다. 의존성도 못 따라가고, 어떤 모듈이 뭐 하는 건지도 모르고, 잘못된 모듈을 고쳐서 다른 데서 터진다.

처방: 딥 모듈. 큰 기능을 단순한 인터페이스 뒤에 숨기는 구조. 입구는 간단한데 안쪽이 깊은 것.

좋은 코드베이스는 테스트하기 쉬운 코드베이스다. 또 펀더멘탈 문제로 돌아온다.

5. 사람 머리가 못 따라가면 → 그레이박스 전략

AI 덕에 코드 양이 폭증하는데 사람 머리가 못 따라간다. 포콕 본인도 "역대급으로 피곤하다"고 인정.

처방: 그레이박스. 인터페이스는 사람이 직접 설계하고 안쪽 구현은 AI한테 통째로 위임. 사람은 인터페이스 단위로만 검증한다.

인터페이스를 설계하라. 구현은 위임하라.

6. 관통하는 한 줄

켄트 벡의 말: 매일 시스템 설계에 투자하라.

Specs-to-Code는 정확히 그 반대를 한다. 디자인에 투자하는 게 아니라 디자인에서 디스인베스트하는 것.

AI는 병장, 너는 전략가

마지막 비유가 인상적이다.

AI는 코드 변경을 직접 만드는 현장의 병장. 전술 단위. 근데 그 위에 누군가 있어야 한다. 전략 수준에서 생각하는 사람. 그게 바로 나.

그리고 전략가의 무기는 새로 산 도구가 아니라 20년 동안 쌓인 펀더멘탈.


전부 새로운 게 아니다. 다 옛날 책에 있는 내용이다. 프래그매틱 프로그래머, DDD, 필로소피 오브 소프트웨어 디자인...

근데 AI 시대일수록 더 강력해진다. 이 발표에서 가장 와닿은 한 마디:

새로운 도구가 너의 무기가 아니다. 20년 동안 쌓인 펀더멘탈이 너의 무기다.

클로드 코드 쓰면서 계속 느끼는 건데, 결국 내가 아는 만큼만 AI가 도와준다. 내가 설계를 모르면 AI도 헤맨다. 이걸 41만 명이 공감한 거다.

출처: AgentOS — Matt Pocock 발표 해설 | 원본 발표: AI 엔지니어 컨퍼런스 2026.04