Agentic Coding을 위한 교훈: 코드가 저렴할 때 우리는 무엇을 해야 할까?

Source: Hacker News

최근 이 블로그에서는 에이전시 코딩에 관한 글을 많이 다루고 있습니다. 최신 모델들은 요즘 코딩에 정말 뛰어나며, 다른 작업에 비해 훨씬 더 잘합니다. 에이전트와 함께 코딩하는 것은 미래를 미리 보는 느낌이며, 에이전트 능력을 얼마나 끌어올릴 수 있는지 실험하는 놀이터와 같습니다. 활기차고 보람 차며, 깊이 이상합니다.

저는 에이전시 코딩을 위한 팁을 계속해서 정리해 왔습니다: 코덱스, 클로드 코드, 파이, 혹은 다른 어떤 에이전트를 처음 시작하는 사람에게 줄 수 있는 가이드라인이나 규칙들입니다. 이상적으로는 각 팁이 일반화 가능한 조언이 되어, 어떤 에이전시 프로그래밍에도 적용될 수 있기를 바랍니다. 또한 모델과 툴이 발전함에 따라 지속될 수 있는 견고한 교훈들을 찾고 있습니다.

아래는 현재 제가 정리한 목록입니다: Agentic Coding을 위한 10가지 교훈. 10은 깔끔한 숫자이며, 이를 공유하기에 좋은 시점이라고 생각합니다.

분명히 말씀드리자면, 이 가이드라인을 다듬고 모은 것은 저의 공로입니다. 오늘 Kshetrajna Raghavan 님이 저에게 “우리가 비슷한 교훈에 도달하고 있다는 것이 미친 듯하다”고 말씀하셨습니다.
(아래 내용 중 빠진 부분이 있다면, 언제든지 연락 주세요!)

에이전트 코딩을 위한 10가지 교훈

• 배우기 위해 구현하라. Spec-Driven Development을 활용하면 멀리 갈 수 있지만, 코드를 작성하는 행위가 당신이 고려하지 않았던 결정을 드러내고 스펙을 개선합니다 (see more). 코드가 저렴할 때는 배우기 위해 구현하십시오.

• 자주 재구축하라. 일찍 구현하고 자주 구현하여 더 많이 배웁니다. 기발한 사고 실험을 포크하고 다시 코딩하세요. 기능을 얼마나 확장할 수 있는지 확인하십시오. 저렴한 코드는 탐색하고 재창조할 수 있게 해줍니다.

• 엔드‑투‑엔드 테스트에 투자하라. 코드를 저렴하게 재창조할 수 있을 때, 제품의 기능을 측정하는 테스트를 작성하는 데 시간을 투자해야 합니다, 그 기능이 어떻게 수행되는지가 아니라. 우리는 재구축 및 재구현의 자유를 부여하는 행동 계약을 원합니다.

• 의도를 문서화하라. 테스트는 목표를 상세히 보여주고 코드는 방법을 인코딩하지만, 둘 다 왜를 포착하지 못합니다. 코드와 함께 의도를 지속하면 당신과 에이전트가 일관된 방향으로 결정을 누적하는 데 도움이 됩니다.

• 스펙을 동기화하라. 코드와 테스트를 진행하면서 스펙(목표와 계획을 담은 마크다운 파일)을 업데이트하세요 (example). 스펙을 고정된 아티팩트로 취급하면 구현 중에 얻는 학습을 놓치게 됩니다. 최신 상태를 유지하면 스펙이 지속적으로 당신과 에이전트의 선택에 정보를 제공하고, 빈번한 재구축을 쉽게 합니다.

• 어려운 부분을 찾아라. 프로젝트에 충분히 오래 머물면 일은 점점 쉬워지지 않습니다. 보일러플레이트와 명백한 설계 결정을 빠르게 지나가다 보면, 직관적 설계, 성능, 보안, 회복력, 시스템 아키텍처와 같은 보기 싫고 어려운 작업에 부딪히게 됩니다. 누구나 쉬운 부분은 즐길 수 있습니다. 어려운 작업이 가치가 있는 곳이다. 그것을 찾아 파고들어라.

• 쉬운 것은 모두 자동화하라. 어려운 작업에 더 많은 시간을 쓰려면 쉬운 일에 드는 시간을 최소화하세요. 학습을 스킬로 정제하고, 루프를 만들고, 코드 리뷰를 자동화하며, 도구가 누적되게 하세요. 하지만 주의: Mystery House에 갇히지 않도록.

• 취향을 개발하라. 코드가 빠르게 나오지만 피드백이 따라오지 않을 때, 따라잡을 수 있는 유일한 피드백은 자기 자신입니다. 도메인, 사용자, 그들의 문제를 잘 알수록 체크인 없이도 더 멀리 갈 수 있습니다.

• 에이전트는 경험을 증폭시킨다. 재능 있는 개발자는 프롬프트에 얼마나 많은 직관을 제공하는지 과소평가합니다: 올바른 용어, 올바른 프레이밍, 적절한 구체성 수준. 스택을 잘 알면 구현과 디버깅 모두에서 수많은 사이클을 절약하고 불필요한 에이전트 탐색을 줄일 수 있습니다. 기술 전문성을 뛰어난 취향과 결합하면 무적의 이점을 얻습니다.

• 코드는 저렴하지만, 유지보수, 지원, 보안은 그렇지 않다. 에이전트 코드는 “강아지처럼 무료.” 지원은 저렴하지 않으며 보안도 저렴하지 않다. 빠르게 구축하되, 채택하는 유지보수를 염두에 두세요.