AI 시대에 코드보다 중요한 것은 '의도'이다: INTENT.md 구조 제안

커뮤니티 반응

대체로 긍정적이며, AI와 협업하는 새로운 개발 패러다임에 대해 많은 사용자가 공감을 표시했습니다.

주요 논점

01찬성다수

코드는 가변적인 결과물일 뿐이며, 개발자의 진정한 가치는 의도를 설정하고 판단하는 데 있다는 주장에 다수가 동의함

합의점 vs 논쟁점

합의점

AI는 코드 생성을 가속화하지만, 무엇을 만들어야 할지 결정하는 것은 여전히 인간의 몫이다.
실패한 시도에서 얻은 학습 내용을 기록하는 것이 프로젝트의 장기적인 자산이 된다.

실용적 조언

프로젝트 루트에 INTENT.md를 생성하고 Why, What, Not, Learnings 섹션을 만들어 관리하십시오.
AI가 잘못된 코드를 내놓는다면 프롬프트 기술을 탓하기 전에 본인의 의도가 명확했는지 먼저 점검하십시오.

섹션별 상세

AI가 저장소의 거의 모든 구성 요소를 재생성할 수 있지만 개발자의 '의도'만은 대체할 수 없다는 점이 강조됐다. 코드, 테스트, 설정 파일 등은 파생 가능한 결과물에 불과하며, 프로젝트가 왜 존재하는지 무엇을 만들고 만들지 않을지에 대한 결정만이 개발자의 고유 영역으로 남는다. 이러한 의도는 프로젝트 시작 시점에 완성되는 것이 아니라 AI와의 상호작용을 통해 점진적으로 구체화된다.

AI를 단순한 코드 생성기가 아닌 '학습 파트너'로 정의하며 빠른 프로토타이핑의 중요성을 언급했다. 모호한 아이디어를 수 분 내에 프로토타입으로 구현하여 실제로 확인하는 과정을 통해 개발자는 자신이 진정으로 원하는 것이 무엇인지 깨닫게 된다. 수 주가 걸리던 잘못된 방향의 개발 과정을 단 몇 시간의 학습 루프로 단축하여 의도를 명확히 다듬을 수 있다.

의도를 체계적으로 관리하기 위해 INTENT.md라는 문서 구조를 제안하고 구체적인 항목을 제시했다. 이 문서에는 'Why(이유)', 'What(무엇)', 'Not(제외 사항)', 'Learnings(학습 내용)'를 포함하여 프로젝트의 진화 과정을 기록한다. 의도는 씨앗(Seed) 단계에서 탐색(Exploring)을 거쳐 명확화(Clarified)되거나 폐기(Killed)되는 생명 주기를 가지며, 모든 실패는 학습 내용으로 자산화된다.

실제로 Claude Code 플러그인과 웹사이트를 이 방법론으로 구축하며 의도 정의와 판단에 집중한 사례를 공유했다. 개발자는 상위 수준의 의도 설정과 결과물에 대한 판단(Judgment)을 담당하고, AI는 그 외의 모든 구현 작업을 수행하는 협업 모델이다. AI의 출력이 기대에 미치지 못할 때 그것이 프롬프트의 문제인지 아니면 개발자의 의도가 불분명했기 때문인지 구분하는 것이 핵심이다.

용어 해설

의도 기반 개발(Intent-Driven Development): — 코드 구현 자체보다 개발자의 의도와 목적을 정의하는 데 집중하는 방식이다. AI가 코드를 생성할 수 있게 됨에 따라 개발자는 '무엇을, 왜' 만드는지에 대한 의도를 명확히 하고 AI와 협력하여 이를 구체화한다.
프로토타이핑 루프(Prototyping Loop): — 아이디어를 빠르게 시제품으로 만들고 피드백을 통해 수정하는 반복 과정이다. AI를 활용해 수 분 내에 프로토타입을 제작함으로써 개발자가 자신의 의도가 맞는지 즉각 확인하고 학습할 수 있게 한다.
컨텍스트 윈도우(Context Window): — AI 모델이 한 번에 처리할 수 있는 정보의 양을 의미한다. 본문에서는 AI가 프로젝트의 의도와 학습 내용을 이해하기 위해 참조해야 하는 정보의 범위와 관련하여 맥락상 중요하게 작용한다.

언급된 도구

Claude Code추천

AI 기반 코딩 보조 및 플러그인 개발 도구