나의 AI 에이전트의 두뇌를 오픈 소스로 공개합니다. 그것은 18개의 마크다운 (Markdown) 파일입니다.

일주일 동안 자율적인 AI 에이전트(autonomous AI agent)를 실행하며 — Reddit에서 일거리를 스캔하고, 기사를 게시하고, 카르마(karma)를 쌓고, 리드(leads)를 추적하면서 — 저는 가장 가치 있는 부분이 코드가 아니라는 것을 깨달았습니다. 코드는 없었습니다.

전체 시스템은 18개의 마크다운 (Markdown) 파일로 이루어져 있습니다.

작동 방식

에이전트는 매 사이클의 시작 시점에 "두뇌 (brain)" 파일을 읽습니다. 이 두뇌는 다음을 정의합니다:

1. 루프 (The Loop): 상태 읽기 → 결정 → 실행 → 메모리 업데이트 → 보고
2. 의사결정 폭포 (Decision Waterfall): 우선순위에 따른 다음 행동
3. 신호등 시스템 (Traffic Light System): 어떤 행동에 인간의 승인이 필요한지
4. 가드레일 (Guardrails): 에이전트가 절대 해서는 안 되는 10가지 사항
5. 전략 가중치 (Strategy Weights): 콘텐츠, 리드, 일거리 사이에 시간을 어떻게 배분할지

그런 다음 에이전트는 8개의 메모리 (memory) 파일을 읽어 어디서 멈췄는지 파악하고, 다음 행동을 선택하여 실행한 뒤, 모든 파일을 업데이트합니다.

메모리 시스템 (The Memory System)

memory/
├── state.md          ← "세이브 게임" — 에이전트가 현재 있는 위치
├── daily-log.md      ← 추가 전용 저널 (항목을 절대 삭제하지 않음)
...

핵심 규칙: daily-log.md는 **추가 전용 (append-only)**입니다. 다른 모든 파일이 손상되더라도, 저널은 전체 이력을 보존합니다. 이 덕분에 이미 두 번의 위기를 넘겼습니다.

에이전트가 실제로 한 일

예산 0달러로 7일 동안:

• Dev.to와 Medium에 12개의 기사 게시
• Reddit에서 18개의 프리랜서 리드(leads) 발견
• Reddit 카르마(karma)를 1에서 140으로 구축
• 플랫폼 역학에 관한 19가지 교훈 습득
• 수익 0달러 생성 (솔직한 사실)

시스템은 작동합니다. 수익은 여전히 인간의 문제입니다.

왜 마크다운 (Markdown)인가?

데이터베이스 없음. API 없음. 배포 없음. 의존성 없음.

모든 LLM은 마크다운을 읽을 수 있습니다. 모든 개발자는 마크다운을 편집할 수 있습니다. 에이전트의 전체 상태는 인간이 읽을 수 있고, 버전 관리가 가능하며, 텍스트 파일을 여는 것만으로 디버깅(debug)할 수 있습니다.

무언가 잘못되었을 때, 로그를 확인하는 것이 아니라 state.md를 읽으면 됩니다.

3가지 질문 테스트

에이전트가 어떤 행동을 취하기 전에, 세 가지 질문에 답합니다:

1. 이것이 되돌릴 수 있는 작업인가? (Is this reversible?) → 예(yes)라면 GREEN, 아니오(no)라면 YELLOW
2. 이 작업에 다른 사람이 관여하는가? (Does this involve another human?) → RED. 언제나 그렇습니다.
3. 이 작업이 의무(obligation)를 생성할 수 있는가? → RED. 예외는 없습니다.

만약 답변할 수 없다면 → 기본적으로 RED입니다. 이 단 하나의 프레임워크가 모든 심각한 실수를 방지했습니다.

키트 받기 (Get the Kit)

저는 전체 시스템 — 두뇌, 메모리 템플릿, 설정 파일(config files), 퀵스타트 가이드 — 을 스타터 키트로 패키징했습니다. 18개의 파일로 구성되어 있으며, 5분 안에 복사하여 맞춤 설정할 수 있습니다.

Claude, GPT, 또는 파일을 읽을 수 있는 모든 LLM(대규모 언어 모델)과 함께 작동합니다.

AI 에이전트 실험 1주 차. 12개의 아티클, 18개의 리드(leads), 19개의 레슨, 수익 $0. 인프라는 탄탄합니다. 수익은 다음 단계입니다.