AI 보조 코딩 10가지 팁: 컨텍스트 관리·스킬·플랜 모드로 생산성 높이기

핵심 메시지

• AI 코딩의 출발점은 도구가 아니라 마음가짐 — '정교한 자동완성'이 아니라 함께 일하는 페어 프로그래밍 파트너로 대하라.
• 맥락(컨텍스트)은 왕이자 한정된 자원이다. 컨텍스트 창의 70~80%를 넘기면 품질이 떨어지니 작업이 끝날 때마다 새 맥락으로 비우라.
• 스킬(skill)에 투자하라 — 특정 공급자에 묶이지 않는 마크다운 기반의 재사용 가능한 작업 방식으로, 한 번 이상 하는 일은 스킬로 만들 가치가 있다.
• 모든 작업은 플랜 모드로 시작해 읽기 전용으로 안전하게 탐색하고, AI가 질문하게 해 더 나은 계획을 세우게 하라.
• 코딩이 더 이상 병목이 아니게 되면서 병목은 양쪽 끝 — 무엇을 만들지 정의하는 일과, 결과를 검증·평가하는 일 — 으로 옮겨간다.

쉽게 이해하기

발표자 알렉스는 머신러닝·패턴 인식 배경의 개발자였지만 지난해 8월 이후 코드를 한 줄도 직접 쓰지 않았다고 말하며, 도구에 상관없이 대체로 통용되는 AI 보조 코딩 팁 열 가지를 빠르게 풀어낸다. 일부 예시는 Claude에 특화돼 있지만, 핵심은 Codex·Copilot 등 어떤 코딩 에이전트에도 적용된다.

0번 팁은 마음가짐이다. AI를 게으르게 굴리며 결과를 그냥 받아들이면 사용자도 함께 무뎌지지만, 적극적으로 '루프 안'에 머물며 설명을 요청하고 배우면 어느 때보다 새로운 것을 익히기 쉽다. 발표자는 시간이 갈수록 AI가 같은 실수를 반복하지 않고 개선되는 '컴파운드 엔지니어링'을 강조하며, 그 출발은 '방금 한 실수에서 배워라, 다시는 그러지 마라'고 AI에게 명시적으로 말하는 단순한 습관이라고 설명한다.

이어지는 팁들은 맥락 관리에 집중된다. 컨텍스트 창은 물잔과 같아 가득 차면 넘치고, 자동 압축이 일어나면 중요한 정보를 잃을 위험이 있다. 그래서 작업마다 새 맥락으로 비우고, 복잡한 일은 각자 독립된 컨텍스트 창을 가진 서브 에이전트로 분산하라고 권한다. 또한 claude.md·agents.md 같은 규칙 파일은 온라인에서 베껴오는 것이 아니라 코딩 에이전트와 함께 자기 저장소·취향에 맞게 만들고, 새 모델이 나오면 과거의 비계(scaffolding)가 오히려 발목을 잡을 수 있으니 규칙을 재검토하라고 조언한다.

스킬과 플랜 모드도 큰 비중을 차지한다. 스킬은 본질적으로 지시가 담긴 마크다운 파일이지만 스크립트·템플릿을 묶어 결정론적 동작을 끌어낼 수 있고, 업계 공통 표준이라 이식성이 높다. 한 번 이상 하는 일은 스킬로 만들고, 잘 작동한 작업을 그대로 '스킬로 만들어줘'라고 하면 좋다. 모든 작업은 플랜 모드로 시작하되, 너무 구체적으로 지시하면 AI가 다른 경로를 탐색하지 못할 수 있으니 초반엔 선호를 살짝 미뤄두는 균형도 권한다.

후반부는 '코딩이 더 이상 병목이 아닌 세상'이라는 통찰로 이어진다. 병목이 양 끝 — 무엇을 만들지 설계·기술하는 일과, 만들어진 것을 검증·평가하는 일 — 로 옮겨가므로, 긴 마크다운 계획을 그냥 승인하지 말고 HTML 인터랙티브 화면으로 받아 사람이 루프 안에 머물라고 한다. 이 밖에 브라우저·CLI 도구 연결, 훅(hook)을 통한 결정론적 가드레일, 작업 학습을 깃에 공유하기, `/insights`로 세션을 분석해 반복 작업을 스킬로 전환하기, 여러 에이전트를 워크트리로 병렬 실행하기, 그리고 '가장 좋은 모델을 쓰라(토큰을 더 써도 한 번에 풀면 결국 이득)'는 조언으로 마무리한다.

주요 인사이트

• 컨텍스트 창은 프롬프트뿐 아니라 응답·도구 정의·규칙 파일·로드된 스킬까지 모두 차지하며, 자동 압축 시 호출되지 않은 스킬 정의는 다시 채워지지 않는다.
• GitHub MCP처럼 70개 도구를 한꺼번에 붙이면 인사말도 하기 전에 컨텍스트가 채워지니, 개발자는 가능한 한 CLI 도구를 쓰는 편이 맥락 보존에 유리하다.
• AI는 '당신 말이 맞다'며 쉽게 동조하므로, 초반에 사용자의 선호를 과하게 못 박으면 더 나은 대안을 놓칠 수 있다.
• 훅은 claude.md에 '하지 마라'라고 적는 것과 달리 추론 바깥에서 동작을 강제해, rm 차단이나 자동 린트 같은 가드레일을 결정론적으로 보장한다.
• `/insights`는 세션 데이터를 분석해 반복 명령·실패 지점을 짚고 스킬·훅으로 전환할 구체적 설정까지 제안하는, 컴파운딩의 핵심 도구다.

자주 묻는 질문

관련 AI 소식