AI 코딩을 위한 10가지 Pro Tips

📌 AI 코딩을 위한 10가지 전문가 팁은 무엇인가?

• AI 코딩 에이전트 사용
• 마크다운 파일로 기능 계획
• AI 코드 검토 및 상태 파일 작성
• 여러 AI 에이전트 동시 실행
• 스타터 키트 사용
• 비버 방법(로그 추가)으로 문제 해결
• AI 에이전트 컨텍스트 관리
• 코드 품질 개선 기회 지속적 탐색
• 규칙 파일 사용
• 나쁜 코드가 자리 잡지 않도록 경계하는 것입니다.

핵심은 AI 에이전트를 적극적으로 활용하여 전체 기능을 구축하고, Markdown 파일을 통해 사전 계획을 수립하여 작업 효율성을 높이는 것입니다. 또한, AI에게 코드 검토및 상태 파일작성을 맡겨 코드 품질을 개선하고, 여러 AI 에이전트를 동시에 실행하여 시간을 절약할 수 있습니다. 프로젝트 시작 시 스타터 키트를 활용하고, 문제 발생 시 로그를 활용한 ' 비버 메소드'를 통해 효율적인 문제 해결이 가능합니다. AI 에이전트의 컨텍스트를 적극적으로 관리하고, 코드 품질, 성능, 보안을 지속적으로 개선하며, 규칙 파일을 활용하여 AI 에이전트의 명령 실행을 돕는 것이 중요합니다. 마지막으로, 나쁜 코드가 자리 잡지 않도록 경계하고, 코드에 대한 지속적인 관심과 관리가 필요함을 강조합니다. 이 팁들을 통해 ai 코딩을 더욱 효율적이고 효과적으로 수행할 수 있습니다.

 

1. 💡 AI 에이전트를 활용한 전체 기능 구축의 중요성

• 최근 AI 코딩방식이 급격히 변화했으며, 6개월 전의 기법은 더 이상 최적의 방법이 아니다 .
• 혁신적 AI 코딩효율을 위해 10가지 팁을 실천하면 신속하면서도 높은 품질의 소프트웨어 개발이 가능하다 .
• Cursor나 Claude Code와 같은 플랫폼에서, 하나의 에이전트를 통해 전체 파일을 읽고, 관련 컨텍스트를 찾으며, 여러 파일을 동시에 수정해 기능을 완성할 수 있다 .
• 반복적 복사-붙여넣기나 오토컴플릿을 사용하는 대신, 에이전트로 한 번에 전체 기능을 구축하는 것이 효과적이다 .
• Sonnet 4등 현대적 모델은 이러한 방식에 충실하게 대응하며, 현재 AI 코딩의 병목은 정확한 저수준 코드에서 전체 기능 구현 및 요구 사항 부합으로 이동했다 .

2. 📝 기능 기획을 위한 마크다운 파일 활용

• AI 에이전트에게 기능을 사전 계획하고 정리하는 단계를 맡기기 위해 Markdown 파일을 사용한다.
• 이 방법은 작업을 여러 개로 나누고, 에이전트가 작업 중에 모든 것을 즉석에서 해결하지 않아도 되도록 돕는다.
• 미리 계획을 세우고 검토하여, 기대하는 구현 방식과 일치하는지 확인하는 과정이 중요하다.
• 현재 대부분의 코딩 시간은 기능 작동 방식을 구체화하고, 에이전트에게 위임하는 과정에 소요된다고 볼 수 있다.
• 이를 실천하는 방법은, 원하는 기능을 설명하고 계획서를 마크다운 파일로 만들도록 요청하는 것이다.
• 계획서 검토 후 수정 요청이 가능하며, 별도 AI 에이전트를 통해 plan을 검토하고 작업을 시작시킨다.
• 이 과정은, 완벽한 프롬프트를 문서로 만들어 에이전트에게 제공하는 것과 같다.
• 최종적으로, 이 방법은 에이전트가 모든 작업을 완료할 수 있도록 명확한 작업 지침과 문서를 제공하는 것이다.

3. 📝 AI의 코드 검토와 상태 파일 작성의 중요성

• AI가 완성한 코드 이후에는 AI에게 전체 코드를 검토하고 상태 파일을 작성하게 하는 것이 권장된다
• 이 과정은 버그 또는 결함을 사전에 발견하는 데 도움을 준다
• AI는 변경된 코드와 원래 계획을 비교하여 상태 문서를 작성하며, 이는 이후 AI가 작업을 계속 이어받는 데 유용하다
• 작성된 상태 문서를 활용하면, 기존 문서와 최신 상태를 기반으로 새 AI에게 작업을 인계할 수 있다

4. 💡 여러 AI 에이전트를 동시에 실행하는 방법

• 여러 AI 에이전트는 파일 열기, 읽기, 수정 기능을 갖추고 있기 때문에, 여러 작업을 수행하는 데 시간 소요가 크다 .
• 대기하지 않고, 멀티태스킹으로 병렬 작업을 수행하는 것이 효율적이다 .
• Cursor에서는 별도 채팅창이나 백그라운드 에이전트를 통해, Claude Code에서는 작업(task) 기능으로 동시에 여러 작업을 할 수 있다 .
• 여러 에이전트 활용은 새로운 프롬프트 작성과 결과 검토 시간을 최대화하며, 작업 흐름을 유지하는 데 도움을 준다 .
• 실전에서는 서로 관련 없는 기능을 각각의 에이전트가 담당하게 하여 충돌이나 파일 오버라이드를 방지하는 것이 바람직하다 .
• 에이전트가 서로 같은 파일에 작업하지 않도록 분리하는 것이, 수동 승인이나 충돌 방지에 효과적이다 .

5. 🚀 프로젝트 빠른 시작을 위한 스타터 킷 활용

• AI 에이전트를 이용해 프론트엔드와 백엔드를 각각 별도 에이전트가 구축하게 하면, 코드의 집중도와 품질이 향상되고, 제작 속도가 빨라진다 .
• 새 프로젝트 시작 시, 전체 구성을 빠르게 세팅하기 위해 스타터 킷을 사용하는 것이 효과적이며, 매번 반복되는 설정 작업( Tailwind, Shad CN, 데이터베이스 연동 등)을 피할 수 있다 .

6. 🐻 비버(Beeaver) 방법을 이용한 문제 해결 전략

• 문제 발생 시, AI가 정확한 원인 파악이 어렵다는 점을 고려하여, 로그(log)를 추가하는 것이 효과적이다
• 로그를 통해 코드를 실행한 후, 해당 로그를 AI에 복사해서 보여주면 문제의 구체적 원인 위치를 파악하는 데 도움이 된다
• AI에게 문제의 상위 5개 원인을 생각하게 하고, 각각의 원인에 도움이 되는 로그를 추가하도록 요청하면 문제 해결이 더욱 용이하다
• 이 방법은 문제 해결 과정을 크게 간소화하고 속도를 높여준다는 점에서 유용하다

7. 📝 AI 에이전트의 컨텍스트 관리는 성능 향상에 중요하다

• AI 에이전트의 컨텍스트 윈도우가 너무 많아지면 성능이 저하되므로, 불필요한 정보를 무시하는 것이 필요하다
• 에이전트가 특정 작업에 집중할 수 있도록 관련 파일과 문서들을 정리하는 문서화 방안이 매우 유용하다
• 핵심 정보와 로그, 에러, 태그된 파일 등을 집중적으로 관리하여, 컨텍스트를 짧고 핵심적으로 유지하는 것이 좋다
• 과도한 정보로 인한 부담을 줄이고, 새롭고 효과적인 대화를 위해 자주 새로운 세션을 시작하는 것이 필요하다

8. 🛠️ AI 개발 시 지속적인 코드 개선 기회 탐색의 중요성

• AI를 개발할 때는 단순히 기능을 추가하는 것뿐 아니라 지속적으로 코드 품질, 성능, 보안을 향상시킬 기회를 찾는 것이 중요하다 .
• 이러한 접근법은 개발자가 자신 있는 코드를 작성하게 하고, 이후 발생할 수 있는 문제를 사전에 방지하는 데 도움이 된다 .
• 예상하기 어려운 성능, 보안, 코드 품질 문제를 해결하기 위해, Vibe Scan이라는 도구가 개발되고 있으며, 이는 코드를 분석하여 잠재적인 문제를 평가한다 .
• Vibe Scan은 개발자가 확신을 갖고 AI 코드를 배포할 수 있도록 도와주며, 예기치 못한 문제를 미연에 방지하는 역할을 한다 .

9. 💡 규칙 파일을 활용하여 AI 에이전트의 명령 수행을 지원한다

• 에디터에서 규칙 파일(예: 커서 규칙)을 사용하면 AI가 올바른 명령을 실행하는 데 도움이 된다 .
• 규칙 파일은 최소한의 규칙으로도 성능 향상에 효과적이며, 사용자는 자신이 주로 사용하는 기술과 명령 유형에 맞춰 규칙을 작성한다 .
• 환경 변수에 대한 접근 제한 규칙도 포함하여, 보안을 위해 git ignore에 저장된 비밀 정보가 노출되지 않도록 한다 .
• 일부 도구는 더 정교한 규칙 파일과 테스트 드리븐 개발 방식을 활용하기도 한다 .
• 규칙 파일이름은 표준화되어 있지 않아 사용하는 에디터에 맞는 파일을 선택해야 하며, Cursor의 경우 ' Cursorrules'이다 .
• 🚫 부적절한 코드 발생 시 즉시 수정하고 엄격히 관리한다
  • AI가 만든 기능이 기대와 다를 경우, 즉시 AI를 멈추고 이전 상태로 롤백하며, 명확한 프롬프트로 재시도하는 것이 중요하다 .
  • 모든 파일이 방치되거나 문서에 잘못 기록되는 것을 방지하기 위해, 중간 체크포인트에서 수정하는 습관이 필요하다 .
  • 코드의 품질과 정확성을 유지하기 위해, 지속적으로 코드를 검토하고 무심코 넘어가지 않으며, 꼼꼼한 관찰이 필수적이다 .
  • 주어진 기법들을 활용하여 빠르고 높은 품질의 소프트웨어를 개발하는 것이 가능하다 .

 

AI 코딩 방식이 최근 몇 달 사이에 확 바뀌었어요. 예전에는 AI가 작은 코드 조각만 만들었다면, 이제는 전체 기능을 통째로 개발할 수 있게 되었죠 . 마치 한 명의 똑똑한 조수에게 큰 업무 단위를 맡기는 것과 같아요 . cursor나 Claude Code 같은 도구를 사용하면 AI 에이전트가 파일들을 읽고 여러 파일을 한 번에 수정해서 기능을 완성해 줘요 . 이제 작은 기능 하나하나에 시간을 쏟지 말고, AI 에이전트에게 큰 그림을 맡겨보세요 .

 

코딩 전에 계획부터 세우는 습관! Markdown로 정리해요.

단계	내용	비고
1	코딩 전 계획 수립	마크다운 파일로 정리
2	AI 에이전트에게 계획 수립 요청	원하는 기능 설명 제공
3	AI가 생성한 계획 검토 및 수정	코딩 시간의 대부분을 차지할 정도로 중요
4	수정된 계획을 새로운 AI 에이전트에게 전달	명확한 정보 제공
5	AI 에이전트에게 코딩 작업 위임	작업을 나누어 효율적으로 진행

• AI 에이전트에게 코딩을 맡기기 전에, 먼저 계획을 세우는 것이 정말 중요해요 .
  • 이 계획은 마크다운 파일로 작성하는 것이 좋아요 .
• 계획을 미리 세우면 AI 에이전트가 모든 것을 스스로 파악할 필요 없이 작업을 나누어 더 효율적으로 일할 수 있어요 .
  • 마치 건물을 짓기 전에 설계도를 그리는 것처럼요 .
• AI 에이전트에게 원하는 기능 설명을 하고, 계획을 세워 마크다운 파일로 만들라고 직접 요청해 보세요 .
• 이렇게 만들어진 계획을 꼼꼼히 검토하고 필요한 부분을 수정할 수 있어요 .
  • 계획 검토가 코딩 시간의 대부분을 차지할 정도로 중요하답니다 .
• 수정된 계획은 새로운 AI 에이전트에게 전달해서 작업을 시작하게 하는 것이 좋아요 .
  • 이렇게 하면 AI가 명확한 정보를 가지고 일할 수 있어요 .

AI에게 코드 검토와 상태 파일 작성을 부탁해요.

• AI 에이전트가 코딩을 마쳤다면, 다음 단계는 코드 검토예요 .
  • 이것도 AI에게 맡길 수 있어요 .
• AI에게 작성한 코드를 전체적으로 살펴보고 처음 세웠던 계획과 비교해 보라고 요청하세요 .
• 이렇게 하면 코딩 과정에서 생긴 작은 버그나 문제점을 쉽게 찾아낼 수 있어요 .
• AI는 검토 결과와 현재 상태를 담은 '상태 파일'도 작성해 줄 수 있어요 .

여러 AI 에이전트를 동시에 돌리면 시간이 절약돼요!

 

AI 에이전트가 하나의 기능을 완성하는 데는 시간이 조금 걸릴 수 있어요 . 하지만 가만히 기다릴 필요 없어요! 여러 AI 에이전트를 동시에 실행해서 작업 시간을 확 줄일 수 있답니다 . 마치 여러 명의 전문가가 각자 다른 일을 동시에 처리하는 것처럼요 . cursor에서는 새 채팅을 열거나 백그라운드 에이전트를 실행하고, Claude Code에서는 '태스크' 기능을 사용하면 돼요 . 이렇게 하면 여러 에이전트의 결과물을 검토하고 새로운 작업을 시작하면서 시간을 효율적으로 사용할 수 있어요 . 가장 좋은 방법은 서로 관련 없는 기능을 각기 다른 에이전트에게 맡기는 거예요 .

 

문제 해결은 '비버 메소드'로! 로그를 활용해요.

 

코딩하다가 문제가 생겼을 때, 말로만 설명하면 AI가 무엇이 잘못되었는지 파악하기 어려워요 . 이럴 때 '비버 메소드'를 사용해 보세요 . 비버가 나무를 하나씩 쌓아 댐을 만들듯, 코드에 '로그(log)'를 추가해서 실행 과정을 기록하는 거예요 . AI에게 로그를 추가해 달라고 요청하고, 프로그램 실행 후 생성된 로그를 AI에게 보여주면 문제의 원인을 훨씬 쉽게 찾아낼 수 있어요 . 더 나아가, AI에게 발생 가능한 주요 원인 5가지를 생각해 보고, 각 원인을 확인할 수 있는 로그를 추가하도록 요청할 수도 있어요 . 이 방법은 문제 해결 과정을 간단하고 빠르게 만들어 줘요 .

 

AI 에이전트의 컨텍스트를 잘 관리해 주세요.

 

• AI 에이전트와 대화하다 보면 이것저것 많은 정보가 쌓여요 .
• 하지만 AI가 너무 많은 정보를 가지고 있으면 중요한 것에 집중하지 못하고 헤맬 수 있어요 .
• 마치 책상 위에 불필요한 서류가 너무 많으면 필요한 서류를 찾기 어려운 것처럼요 .
• 따라서 AI 에이전트가 특정 파일 그룹에만 집중하도록 컨텍스트를 적극적으로 관리하는 것이 중요해요 .
• 앞서 이야기한 계획 문서나 상태 파일은 AI가 필요한 정보만 파악하는 데 큰 도움이 돼요 .
• AI가 작업할 때 관련 있는 코드 파일만 태그해주고, 발생하는 오류나 로그를 복사해서 보여주는 것도 좋아요 .
• 필요하다면 AI가 웹에서 추가 정보를 검색하도록 '@web' 태그를 사용할 수도 있어요 .
• 핵심은 AI의 컨텍스트를 최소한으로 유지하고, 필요하다면 새로운 대화를 자주 시작하는 거예요 .

기능 개발 외에 코드 품질 개선도 AI에게 맡겨요.

 

• AI는 단순히 기능만 만드는 도구가 아니에요 .
• AI 에이전트에게 코드 품질, 성능, 보안 문제를 꾸준히 점검하고 개선해 달라고 요청할 수 있어요 .
• 이렇게 하면 코드를 만드는 동시에 안정적이고 효율적인 코드를 유지할 수 있어요 .
• 나중에 예상치 못한 문제가 생기는 것을 미리 방지할 수 있죠 .

규칙 파일을 활용해서 AI 에이전트를 똑똑하게!

 

• 규칙 파일을 사용하면 AI 에이전트가 특정 작업을 올바르게 수행하도록 도울 수 있어요 .
• 처음에는 규칙 파일 사용이 어렵게 느껴질 수 있지만, 간단한 규칙만으로도 AI의 성능을 훨씬 좋게 만들 수 있어요 .
• 자신이 사용하는 기술이나 필요한 명령어에 대한 규칙만 추가해도 충분해요 .
  • 예를 들어, AI가 환경 변수 파일에 접근하지 못하도록 규칙으로 알려줄 수 있어요 .
• 어떤 사람들은 규칙 파일을 활용해서 테스트 코드를 먼저 작성하게 하고, 그 다음에 기능을 구현하도록 하는 '테스트 주도 개발(TDD)' 방식으로 사용하기도 해요 .
  • 이것 또한 규칙 파일의 좋은 활용법이에요 .

나쁜 코드는 절대 용납하지 마세요!

 

AI 에이전트가 코드를 작성하다 보면 가끔 원하는 방향과 다르게 만들 때가 있어요 . 만약 코드가 이상하게 흘러간다고 느껴진다면, 바로 작업을 멈추세요 . 마치 잘못된 길로 가는 차를 멈추는 것처럼요 . 이전 상태로 되돌리고 원하는 내용을 더 명확하게 알려준 다음 다시 시도해야 해요 . 나쁜 코드를 그냥 두면 나중에 고치기 어렵고, 결국 프로젝트 전체에 나쁜 영향을 미칠 수 있어요 . AI가 만든 코드라도 주의 깊게 살펴보고, 깨끗한 코드를 유지하려는 노력이 정말 중요해요.

 

https://www.youtube.com/watch?v=qWm8yJ_mDAs 보며 정리한 내용입니다.