개인 AI 에이전트 구축을 위한 100가지 팁: 클라우드 프로토타입에서 프로덕션까지

한 개발자가 개인 AI 에이전트를 6주 동안 처음부터 구축했습니다. 챗봇 래퍼가 아닌 작업 관리, 거래 추적, 이메일 읽기, 비즈니스 데이터 분석, 놓친 항목 사전 알림까지 하는 지속형 어시스턴트입니다. 프로젝트는 클라우드(공유 메모리 파일, 풍부한 컨텍스트 윈도우, 맞춤형 스킬을 갖춘 Claude Projects)에서 시작했다가 VS Code 내의 Claude Code로 이전되었으며, 이로 인해 로컬 파일 접근, git 추적, 셸 훅, 예약된 헤드리스 작업이 가능해졌습니다. 이전 과정에서 개발자는 존재조차 몰랐던 문제들을 해결해야 했습니다. 이 100가지 팁은 그 결과물이며, Claude 20x 사용량 제한은 처음에는 100% 개발 / 0% 실제 사용에서 6주 후 20% / 80%로 전환되었습니다.

기초 및 정체성 (1–8)

• 시스템 프롬프트가 아닌 헌법을 작성하라. 시스템 프롬프트는 명령을 나열하지만, 헌법은 규칙을 설명합니다. 에이전트가 규칙이 없는 예외 상황에 부딪혔을 때, 헌법으로 추론하여 추측하지 않습니다. 이는 우아하게 성능이 저하되는 에이전트와 자신 있게 환각하는 에이전트를 구분합니다.
• 에이전트에 이름, 말투, 역할을 부여하라. 예: "항상 1인칭. 직설적. 감정보다 데이터. 불필요한 표현 없음. 요약 없음." 이렇게 하면 세션당 수백 가지의 미세 결정이 사라지고 감사 일관성이 생깁니다.
• 엄격한 규칙과 행동 지침을 분리하라. 엄격한 규칙은 전용 섹션에 두어 절대 재정의되지 않게 합니다. 행동 지침은 적응합니다. 둘을 섞으면 둘 다 무의미해집니다.
• 주인을 깊이 정의하라. 에이전트는 누구를 섬기는가? 무엇이 그들을 불편하게 하는가? 그들은 어떻게 결정하는가? 예: "데이터로 결정, 직감이 아님. 단일 추천이 아닌 점수가 포함된 대안을 원함. 모호한 답변을 싫어함."
• 능력 지도와 구성 요소 지도를 별도로 구축하라. 능력 지도: 에이전트가 할 수 있는 것(스킬, 통합, 자동화). 구성 요소 지도: 어떻게 구축되었는지(파일, 연결). 이 둘을 혼동하면 3개월 후에 쓸모없는 문서가 됩니다.
• 에이전트가 아닌 것을 정의하라. "요약기가 아님. 무조건 동의하는 기계가 아님. 검색 엔진이 아님. 질문을 기다리지 않음." 부정적 정의는 일반적인 도움됨으로의 표류를 방지합니다.
• THINK vs. DO 사고 모델을 구축하라. 불확실할 때 → THINK (분석, 초안, 준비). 명확할 때 → DO (실행, 작성, 전달). 절대 멈추지 않음. 가장 낮은 위험 수준에서 기본적으로 행동하고 결과를 표시합니다.
• ID 파일을 git에서 버전 관리하라. git blame을 설정에 사용하면 특정 편집으로 추적되는 행동 회귀를 디버깅하는 데 도움이 됩니다.

메모리 시스템 (9–18)

• 메모리에 데이터베이스 대신 플랫 마크다운 파일을 사용하라. 읽기 쉽고, grep 가능하며, git 추적이 가능하고, 에이전트가 직접 로드할 수 있습니다. 인프라 계층이 필요 없습니다.
• 날짜가 아닌 도메인별로 메모리를 분리하라. entities_people.md, entities_companies.md, entities_deals.md, hypotheses.md, task_queue.md 같은 파일. 하나의 파일 = 하나의 도메인. 시간순 덤프는 2주 후에 검색 불가능해집니다.
• MEMORY.md 인덱스 파일을 구축하라. 각 메모리 파일을 한 줄 설명과 함께 나열하는 단일 인덱스. 에이전트는 인덱스를 먼저 로드하고 필요 시 특정 파일을 가져옵니다. 컨텍스트 윈도우 사용량을 예측 가능하게 유지합니다.
• "캐시"와 "진실 공급원"을 명시적으로 구분하라. 모든 캐시 파일에 last_sync: 타임스탬프를 표시합니다. 예를 들어 로컬 deals.md는 CRM의 캐시이고, CRM이 SSOT입니다.