프롬프트 더미 대신 헌법으로 대체하기: AI 코딩 에이전트를 16개 역할의 회사로 조직화하는 방법
요약
AI 코딩 에이전트의 복잡한 프롬프트 더미 문제를 해결하기 위해 '페르소나' 대신 구조화된 '정관(Charters)'을 도입하는 방법을 제시합니다. 이 정관은 임무, 의사결정 프레임워크, 협업 프로토콜 등을 명시하여 에이전트의 행동에 일관성과 견고한 운영 체제를 부여합니다.
핵심 포인트
- 단순 페르소나보다 '정관(Charters)'이 에이전트 구조를 지탱하는 핵심입니다.
- CEO 역할, 리스크 오피서 등 16개 전문 역할을 조직화하여 의사결정을 분산시킵니다.
- 모든 주장은 증거 수준별로 등급화되어야 하며, 검증 없이는 완료가 아닙니다.
많은 분들처럼 저도 하나의 AI 코딩 에이전트와 점점 쌓여가는 프롬프트 더미에서 시작했습니다. 사건이 발생할 때마다 새로운 패치가 생겼습니다: 'X를 할 때는 Y를 기억해라.' 몇 달 만에 그 더미는 읽을 수 없을 지경이었고, 에이전트는 절반을 무시했으며, 저는 여전히 매 세션마다 같은 결정을 재설명해야 했습니다.
변곡점은 더 나은 모델이 아니었습니다. 그것은 다른 질문이었습니다. '어떤 프롬프트가 이것을 고칠까?'라고 묻는 대신, 저는 '누가 이 결정에 대한 소유권을 가지는가?'라고 묻기 시작했습니다.
1. 페르소나 스티커 vs. 강제적인 정관(Charters)
찾아볼 수 있는 대부분의 'AI 팀' 템플릿은 페르소나 스티커에 불과합니다: '당신은 깨끗한 코드를 좋아하는 선임 엔지니어인 Alice입니다.' 재미있지만, 구조를 지탱하기에는 부족합니다.
실제로 제 에이전트의 행동을 바꾼 것은 페르소나가 아닌 **정관(charters)**을 작성하는 것이었습니다. 제가 설정한 모든 역할은 다음을 명시하는 문서를 가지고 있습니다:
- 임무 (Mission) — 이 역할이 무엇을 위해 존재하는지 한 문장으로 정의합니다.
- 의사결정 프레임워크 (Decision framework) — 행동하기 전에 따라야 하는 절차(예: 'X를 구축해야 할까?'라는 질문은 다섯 가지 질문을 거쳐야 한다: 반대할 이유는 무엇인가, 탄약이 있는가, 어떻게 후퇴할 것인가, 전진 기지를 유지할 수 있는가, 누가 실행하는가').
- 협업 프로토콜 (Collaboration protocol) — 다른 역할로부터 받아들여야 하는 것(위험 담당자의 거부는 협상의 여지가 없습니다; 나쁜 소식은 필터링 없이 올라갑니다).
- 하드 경계 (Hard boundaries) — 사용자가 요청할 때조차 넘을 수 없는 선(스팸, 가짜 참여 유도, 공포 마케팅)
- 출력 표준 (Output standard) — 산출물이 어떤 모습이어야 하는지(모든 주장은 증거 수준별로 등급화되어야 함; '검증 실행 없이는 완료가 아니다').
페르소나는 분위기를 더하는 세 줄의 맛입니다. 정관은 실제 운영 체제입니다.
2. 조직도 (16개 역할, 결정 시 인간 개입 제외)
생겨난 구조는 다음과 같습니다:
- 전략과 중재를 담당하는 CEO 역할 에이전트 (모든 곳에 적용되는 단일 의사 결정 프레임워크: 어떤 전투 전에도 다섯 가지 질문)
- 여덟 명의 스태프 오피서: 최고 운영 책임자(Chief of Staff, 순차 관리), 인텔리전스(Intel, 정찰 및 증거 등급화), 제품(Product, 수용 기준), 엔지니어링(Engineering, 구현 및 검증), 성장(Growth, 배포), 리스크 (독립적인 거부권), 기회(Opportunity, 단위 경제학), 통찰력(Foresight, 장기적 베팅)
- 콘텐츠 군단 (작문 / 숏 비디오 / 숏 드라마)과 독립 검토 위원회 — 제작 과정에 보고할 수 구조적으로 금지된 세 명의 리뷰어 좌석. 검토 없이는 출하 불가(No review, no ship).
- 오픈 소스 관행을 지속적으로 정찰하고 흡수하는 상시 정찰 메커니즘 (평가 → 시도 → 채택 → 검토)
내가 가장 중요하다고 예상하지 못한 역할: 바로 리스크 오피서. 에이전트는 자기 보존 본능을 가지고 있지는 않지만, '표류(drift)'를 겪기는 합니다. 이 역할을 맡은 임무 전체는 "아니오라고 말하고, 그 이유를 정당화하는 것"이며, 이는 표류를 조기에 포착합니다.
3. 현실과 접촉하며 살아남은 열 가지 규칙
전체 세트가 패키지로 출하되지만, 다음 세 가지가 핵심적인 역할을 했습니다:
- 주장보다 증거가 우선이다. "작동할 것이다"라는 말만으로는 부족합니다. 검증 명령이 실행되지 않았다면, 그 작업은 완료된 것이 아닙니다. 모든 주장은 등급화됩니다: 기계 수준의 증명, 행동 수준의 증명, 또는 독립적인 확인을 통한 합의입니다.
- 한 번에 하나의 전투만 진행한다. 병렬 처리는 분리된 작문 작업을 가진 독립적인 작업에 적합하며, 세 개의 절반짜리 전쟁에는 절대 그렇지 않습니다. 우선순위 충돌은 경주하는 것이 아니라 중재됩니다.
- 공유된 전투 로그가 기억이다. 모든 행동은 ≤3줄 (결정 + 이유, 또는 실패 + 근본 원인 + 수정)을 하나의 로그 파일에 추가합니다. 다음 세션은 이 로그에서 시작하며, 인간에게 맥락을 다시 설명해달라고 요청하는 일이 없습니다.
마지막 규칙 덕분에 가장 큰 시간 낭비 요소였던 '맥락 재설명'이 조용히 사라졌습니다. 그 로그 자체가 인계 문서입니다.
4. 관료주의 없는 책임성
사람들이 무겁다고 생각할 만한 부분: 바로 프로세스입니다. 하지만 이 과정은 회의를 통해서가 아니라 다른 에이전트들에 의해 강제되기 때문에 무겁지 않습니다.
- 검토 위원회(review corps)는 모든 결과물을 평가하며, 기준치 미달 시 = 자동 재작업, 논의 없음
- 실패는 4단계 근본 원인 조사(root-cause investigation)를 촉발함; 동일한 근본 원인이 두 번 발생할 경우 = 불운이 아닌 프로세스 책임으로 간주됨
- 검증 기록(verification trail) 없이 '완료'된 것은 다음 근무조에 의해 미완료로 취급됨
이를 구현하는 데 필요한 오버헤드는 몇 백 줄의 마크다운일 뿐입니다. 절약되는 비용은 재작업을 하지 않는 것에서 측정됩니다.
5. 과거의 나에게 해주고 싶은 조언
- 프롬프트 수집을 멈추고, 명시적인 **결정 프레임워크(decision frameworks)**를 담은 헌장(charters) 작성에 집중하세요.
- 한 역할에는 거부권(veto power)을 부여하고 그 독립성을 구조적으로 보호하세요.
- 공유 로그 형식(shared log format)부터 작성하세요. 이것이 팀의 진정한 기억입니다.
- 불편하더라도 명확한 경계(hard boundaries)를 유지하세요. 그것이야말로 위임(delegation)을 안전하게 만드는 요소입니다.
6. 패키지 (무료 및 오픈 소스)
저는 이 전체 내용을 Empire Iron Corps로 패키징했습니다. 여기에는 22개의 헌장, 10가지 행동 규범(rules of engagement), 5가지 작업 템플릿, 교훈을 유지하기 위한 지식 그래프 방법론(knowledge-graph methodology)과 세 가지 종속성 없는 검증 스크립트(pack integrity + assembly check + wording lint)가 포함되어 있습니다.
- 저장소(Repo): https://github.com/yyyz1yyyz2/empire-iron-corps
- 다운로드 랜딩 페이지: https://empire-iron-corps.vercel.app
- 라이선스: docs CC BY 4.0, code MIT
솔직한 고지: 이 헌장들은 중국어로 작성되었습니다 (영어 버전은 로드맵에 있습니다). 16명의 멤버 이름과 배경 이야기는 모두 명시적으로 가상의 AI 페르소나입니다. 이들은 실제 자격증으로 제시되기 위함이 아니라 행동을 제약하기 위해 존재합니다. 또한, 이 패키지는 조직적 패러다임을 공유할 뿐, 어떠한 수익 창출 주장도 포함하고 있지 않습니다.
만약 당신이 '많은 에이전트와 책임 소재 불분명' 문제를 다르게 해결했다면, 정말 듣고 싶습니다. 헌장과 공유 전투 로그(shared battle log)가 현재 저의 해답이며, 이것이 유일한 방법은 아닐 것이라고 생각합니다.
공개 고지: 이것은 제가 만든 오픈 소스 프로젝트입니다. 여기에 있는 내용은 유료 홍보가 아닙니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기