오늘 가져갈 3가지

1. 왜 LLM 만으로는 시스템이 안 되는가 — 하네스 4대 기둥
2. 어떻게 우리가 그걸 자체 서비스에 이식했는가 — 20+ 프로젝트 투어 + 라이브 데모
3. 무엇이 바뀌었는가 — 패턴 5가지 + 사고 3건의 교훈

1인이 동시 운영 중인 시스템 — 20+

챗봇 · 콘텐츠 · 책/장편 · 논문/리서치 · 학습 · 실험 · 플랫폼

사람은 한 명. 비결은 — 시스템 자체가 사람처럼 일하기 때문.

AI 엔지니어링 4대 축

"말을 아무리 잘 훈련시켜도 마구가 없으면 밭을 갈 수 없다."
— 하네스 엔지니어링의 핵심 비유

하네스는 다른 3개를 졸업한 다음이 아니라, 처음부터 같이 짜야 한다.

용어

프롬프트 엔지니어링

AI 에게 효과적으로 지시문 작성

컨텍스트 엔지니어링

작업에 필요한 정보·파일·메모리 제공 설계

하네스 (harness)

말의 마구 — AI 가 실수할 수 없는 환경·도구·규칙의 묶음

에이전틱

AI 가 스스로 도구를 골라 실행하는 자율 워크플로우

AI 가 실수 안 하게 만드는 4가지 기둥

용어

린터 (linter)

코드 스타일·오류 자동 검사 도구 (eslint, ruff 등)

pre-commit hook

git 커밋 직전 자동 실행되는 검사 스크립트

데드 코드

참조되지 않아 실행되지 않는 코드

가비지 컬렉션

원래 메모리 자동 회수 개념 — 여기서는 코드·규칙의 자동 정리

Claude Code 가 이미 가진 5요소

용어

Hook

특정 이벤트(세션 시작·도구 호출 등)에 자동 실행되는 셸 명령

Skill

트리거 키워드로 자동 활성화되는 명세 절차 (SKILL.md)

MCP

Model Context Protocol — 외부 서비스를 AI 도구로 노출하는 표준

Sub-agent

격리된 컨텍스트로 작업을 위임 — 메인 세션 오염 방지

5대 시스템 — 각자 잘하는 게 다르다

   프롬프트/컨텍스트   →  gstack         (스킬 팩, 워크플로우)
   도구 실행          →  Claude Code   (에이전트 루프, Hooks)
   채널/상시 운영      →  OpenClaw      (데몬, 채널 라우팅, Scout)
   조직/거버넌스       →  Paperclip     (조직도, 예산, 감사)
   통합 플랫폼        →  SGwannabe     (위 4개 장점 조합)
        

용어

Conductor

gstack 의 병렬 에이전트 실행기 (10~15 에이전트 동시 처리)

Scout loop

주기적으로 시스템을 스캔해서 이상을 자동 task 로 만드는 루프

채널 게이트웨이

텔레그램·Slack·WhatsApp 등 다양한 메신저를 하나로 묶는 허브

오케스트레이션

여러 에이전트·작업의 흐름을 조율하는 상위 레이어

참고한 자료 (원천)

+ Karpathy 4 원칙 (Think Before Coding / Simplicity / Surgical / Goal-Driven) — 페르소나 task 발행 SOP 의 토대.

좋은 점만 골라 우리 환경에 맞게 재조립 — 그대로 들고 오지 않았다.

전체 지도

   ┌─────────────────────────────────────────────────────────────┐
   │              사용자 (텔레그램 / 음성 / 슬래시)              │
   └──────────────┬────────────────────────────┬─────────────────┘
                  │                            │
       ┌──────────▼──────────┐      ┌──────────▼──────────┐
       │  Claude Code CLI    │      │  sgw-backend (8100) │
       │  (개발·운영 IDE)    │      │  대시보드 · API     │
       └──────────┬──────────┘      └──────────┬──────────┘
                  │                            │
                  │              ┌─────────────▼─────────────┐
                  │              │   agent-runner (데몬)     │
                  │              │   31 personas · 3 exec    │
                  │              │   Scouts · Watchdogs      │
                  │              └─────────────┬─────────────┘
                  │                            │
   ┌──────────────▼────────────────────────────▼─────────────────┐
   │  서비스 (20+)                                                │
   │  ┌─ JIINSI · ElectroAssist · gametalktalk · MyMind          │
   │  ├─ BloomWrite · novel_2027 · WORLD LOOK BOOK · TarotBook   │
   │  ├─ leesangjin_paper · sg_deepresearch                      │
   │  ├─ CBT · QPASS · child_q                                   │
   │  └─ voice-persona-lab · KAMRA · InsightX · …                │
   └─────────────────────────────────────────────────────────────┘
        

ElectroAssist — 이미르 전기 전문가 챗봇

JIINSI — 매일 04:50 → 07:00 자동 발행

   05:00  collect      뉴스 수집 (RSS · API)
   06:00  summarize    Vertex Gemini 로 한국어 요약
   06:30  podcast      Gemini TTS → ffmpeg CBR 192k mp3
   07:00  publish      사이트 · 네이버 · 팟빵 · X · 텔레그램 5채널
   25 * * * *  publish_watchdog   매시 25분 실패 자동 재시도
   08:00  naver QA     발행 직후 무결성 점검
   23:00  GA · 네이버 통계 수집
        

• 각 단계는 독립 cron → 한 단계 실패가 다음 단계를 막지 않음 (fail-open)
• publish_history 테이블이 발행 상태의 진실의 원천
• 워치독은 실패만 골라서 재시도 → idempotent

JIINSI 발행 회복탄력성 6-Layer

4-12 ~ 5-4 동안 매일 반복된 5종 사고 → 6-Layer 도입 후 5-9 빈 발행 1건만 발생 → 코드 패치로 차단.

용어

Pre-flight

비행기 이륙 전 점검 — 발행/실행 전 사전 검증

fail-open

일부 실패가 전체를 멈추지 않는 설계 (vs fail-close)

idempotent

같은 작업을 여러 번 해도 결과가 동일 — 재시도 안전

워치독 (watchdog)

실패·이상을 감시하다 자동 복구·알림하는 백그라운드 프로세스

cron

정해진 시간에 자동 실행되는 Linux 작업 스케줄러

SGwannabe — agent-runner 데몬 (gstack + OpenClaw 차용)

   sg-pc1 (PC #1)                            sg-pc2 (PC #2, 예정)
     ├─ agent-runner.service                   ├─ agent-runner.service
     │   ├─ 머신 등록 + heartbeat 30s          │   …
     │   ├─ task fetch (HTTP poll)
     │   ├─ executors/
     │   │   ├─ claude_executor   (Claude Max CLI subprocess)
     │   │   ├─ gemini_executor   (Vertex AI)
     │   │   └─ script_executor   (bash/python)
     │   ├─ scouts/                            ← OpenClaw 차용
     │   │   ├─ code_scout · data_scout
     │   │   ├─ content_scout · pipeline_scout
     │   │   └─ metric_scout    (dedupe 7일)
     │   └─ verify_logger → MySQL + TG
     └─ ~/.sgwannabe/runner.json (상태 파일)   ← gstack 차용

   sgw-backend (8100)  ← 대시보드, task queue, persona registry
        

gstack 의 상태 파일 + 하트비트 + OpenClaw 의 Scout loop + task self-generation 조합. Claude Max CLI subprocess 로 정액제 안에서 무제한 호출.

용어

daemon (데몬)

백그라운드에서 상시 실행되는 프로세스 (systemd 서비스)

heartbeat

"살아있음" 을 주기적으로 알리는 신호 (30초 간격)

subprocess

현재 프로세스에서 띄운 자식 프로세스 — claude CLI 를 이렇게 호출

executor

작업 종류별 실행 핸들러 (claude / gemini / script)

dedupe

중복 제거 — 같은 이슈가 7일 안에 또 잡히면 task 생성 안 함

페르소나 — 31명의 작은 전문가 (Paperclip 조직도)

---
id: jiinsi-cs
name: 이지혜 (JIINSI CS 매니저)
runtime: claude
project: JIINSI
skills:
  - korean-writing
  - customer-service
  - reply-drafting
memory_namespace: jiinsi-cs
---
# 역할
당신은 JIINSI 의 CS 담당자 이지혜입니다.
- 4 외부 채널 + 사이트 댓글 응대
- 24h 안 답글 약속
- 호칭 "독자님" · 이모지 금지
…

용어

runtime

페르소나 실행 환경 — claude / gemini / script 중 하나

memory_namespace

페르소나 전용 메모리 격리 공간 (이지혜의 기억 ≠ 강태주의 기억)

skills 배열

페르소나가 활성화할 수 있는 절차/도구 목록

YAML frontmatter

markdown 파일 맨 위의 --- 블록 메타데이터

텔레그램 음성 지시 → 자율 실행

   1.  사용자 음성    : "이지혜한테 어제 댓글 답글 정리해서 보고하라고 해"
   2.  Telegram bot   →  task queue (MySQL)
   3.  agent-runner   →  persona=jiinsi-cs · runtime=claude · skills 로드
   4.  claude_executor →  Claude Max CLI subprocess
                       ↓
                       4 채널 selenium / tweepy / API 호출
                       ↓
                       답글 초안 작성 → 사용자 승인 대기
   5.  verify_logger  →  TG 로 결과 보고 (텍스트 + 링크)
   6.  사용자가 "ok"  →  실제 게시
        

사람 개입은 의사결정만. 정보 수집 · 초안 · 게시 · 로그는 모두 자동.

운영 결과

사람 1명이 운영. 사고가 났을 때 페르소나가 먼저 알아채고 텔레그램으로 보고한다.

데모 ① · SessionStart hook

claude CLI 실행 → 빈 세션에 컨텍스트 자동 주입

• ① 최근 커밋 (프로젝트별)
• ② 마지막 세션 마지막 교환
• ③ 미정리 repo 경고
• ④ 서비스 헬스 (sgw-backend · agent-runner)

"빈 채팅창이 아니라 방금까지 일하던 동료가 들어옵니다."

하네스 4대 기둥 ①컨텍스트 파일 + ④가비지 컬렉션(미정리 감지)이 한 번에 동작

용어

SessionStart hook

claude CLI 실행 직후 가장 먼저 발동되는 hook — 컨텍스트 자동 주입

미정리 repo

미커밋·미푸시 변경이 남은 git 저장소

컨텍스트 주입

모델 입력에 외부 정보를 자동으로 끼워 넣는 것

데모 ② · 텔레그램 → 페르소나 task

왼쪽 텔레그램, 오른쪽 task queue 라이브

• ① persona 매칭 → jiinsi-cs 자동
• ② skills 자동 로드 → 한국어 글쓰기 / 답글 작성
• ③ verify_handoff → "한번 읽어보시고 OK 주시면 게시"

사람 개입은 의사결정만

용어

task queue

대기 중인 작업 목록 — status: queued → running → done

selenium

브라우저 자동화 도구 (네이버·팟빵 등 RSS 미지원 채널에 사용)

tweepy

X(Twitter) API Python 라이브러리

verify_handoff

작업 완료 후 "사용자가 확인" 단계를 강제하는 패턴

데모 ③ · 워치독이 사고를 잡는 순간

cron log + 텔레그램 알림 + DB 상태 변화

• ① tail -f publish_watchdog_cron.log
• ② 텔레그램 "✓ 1건 자동 재시도 성공"
• ③ DB status: failed → success

"사람이 새벽에 깰 필요 없는 시스템 — 6-Layer 의 끝"

용어

publish_history

발행 이력 테이블 — status, retry_count, recovered_at 컬럼 보유

tail -f

로그 파일의 새로 추가되는 줄을 실시간으로 출력

logNo

네이버 블로그 글 고유 ID — 삭제 시 영구 소실

Smart Editor

네이버 블로그의 작성 에디터 (마크다운 → 네이버 포맷 변환 필요)

패턴 1 · 3계층 컨텍스트

   ┌────────────────────────────────────────────────┐
   │  CLAUDE.md  (전역 · 모든 세션 자동 로드)        │
   │  ─ 개발 철학 · LLM 라우팅 · 보안 · 코딩 규칙    │
   ├────────────────────────────────────────────────┤
   │  Memory  (~/.claude/.../memory/*.md)            │
   │  ─ user / project / feedback / reference        │
   │  ─ MEMORY.md = 인덱스, 본문은 별도 파일         │
   ├────────────────────────────────────────────────┤
   │  Skill  (트리거 키워드로 활성화)                │
   │  ─ 절차 · 체크리스트 · 도메인 지식             │
   └────────────────────────────────────────────────┘
                        ▲
                        │ SessionStart hook 으로
                        │ 자동 결합 + 최근 커밋 / 상태 주입
        

왜 3계층? 전역(항상) / 영속(인덱스로) / 트리거(키워드로) 의 분리. 한 곳에 다 넣으면 컨텍스트 폭발.

용어

CLAUDE.md

Claude Code 가 모든 세션에 자동 로드하는 프로젝트 규칙 파일

인덱스 파일

본문이 아니라 본문 파일 목록만 갖는 파일 (MEMORY.md)

컨텍스트 폭발

한 번에 너무 많은 정보를 넣어 모델 토큰·집중도가 무너지는 현상

패턴 2 · 회복탄력성 6-Layer

JIINSI 사고 5종에서 추출한 일반 원칙

• 1. Pre-flight — 시작 전 사전 점검 (키 · 디스크 · 외부 의존성)
• 2. Fail-open Decoupling — 채널/단계를 독립 cron 으로 쪼개기
• 3. Auto-recovery — 실패는 워치독이 잡아서 재시도 (idempotent)
• 4. Health Check — 발행 후 실제 노출/도달 확인
• 5. Observability — 모든 단계 텔레그램 로깅
• 6. Recovery Automation — 사람 개입 없이 누락분 재발행

새 발행 코드 작성 시 자동 적용 (메모리 feedback_jiinsi_publish_resilience.md).

패턴 3 · 페르소나 자기검증

❌ "팟빵 업로드 완료"
✅ "팟빵에 [제목] 올라갔는데
    한번 들어보시고 음질·길이
    이상 없는지 확인 부탁드립니다."

패턴 4 · 교차모델 검증

"자기 모델이 자기 답을 평가하면 confirmation bias 가 들어간다"

cat prompt.md | \
  claude -p --model claude-sonnet-4-6 \
  --output-format text > result.md
# Claude Max CLI subprocess · 비용 0원

트리거: "검증해줘 · QA · 리뷰 · 비판 · 검토 · double check · second opinion · 독립 검증". 도메인 페르소나 강제 (NeurIPS AC · senior engineer · 임상 통계학자 등).

용어

confirmation bias

자기 답을 옹호하는 편향 — 같은 모델이 자기 결과 평가하면 발생

cross-model verification

다른 Claude 모델 (Opus ↔ Sonnet) 로 페르소나 강제 검증

CLI subprocess

claude -p --model X 비대화형 호출 — Max 정액제 안에서 비용 0

패턴 5 · LLM 호출 단일 정책

"LLM 호출 경로는 두 개만 허용한다"

서비스 추가 시 새 Vertex 키 발급 강제 → billing report 가 서비스별 비용 추적 가능.

용어

Vertex AI

GCP 의 통합 ML 플랫폼 — LLM·embedding·grounding 모두 지원

subprocess (Claude CLI)

Python·Node 등에서 claude CLI 를 자식 프로세스로 호출

billing report

GCP Cloud Billing 의 서비스/키별 비용 분해 리포트

generativelanguage

Gemini AI Studio 의 API 도메인 — 카드 종량, 크레딧 적용 불가

패턴 6 · Karpathy 4 원칙 + Goal-Driven Execution

"LLMs are exceptionally good at looping until they meet specific goals."
— Andrej Karpathy

1. Think Before Coding — 가정 명시. 모호하면 멈추고 질문
2. Simplicity First — 요청 없는 추상화·기능 금지
3. Surgical Changes — 필요한 부분만. 인접 코드 "개선" 금지
4. Goal-Driven Execution — 검증 가능한 목표 + 통과까지 자율 반복

Transform 패턴: "Fix the bug" → "Write a test that reproduces it, then make it pass"

31명 페르소나 task 발행 SOP. 메모리 _KARPATHY_4.md.

용어

Karpathy

Andrej Karpathy — OpenAI/Tesla 출신 AI 연구자

Goal-Driven Execution

검증 가능한 목표 + 통과까지 자율 반복 — LLM 의 강점 활용

Surgical Changes

외과 수술처럼 필요한 부분만 정확히 수정

SOP

Standard Operating Procedure — 표준 업무 절차서

사고 #1 · JIINSI 빈 newsletter 발행 (5/9)

용어

fallback

primary 가 실패했을 때 쓰는 대체 경로

stub

실제 내용 대신 들어가는 임시·빈 자리 (이번 사고의 원흉)

abort

비정상 상태 감지 시 즉시 중단 — 빈 결과를 후속 단계에 흘려보내지 않음

사고 #2 · 본인 IP 자동 차단 (5/10)

용어

fail2ban

의심스러운 IP 를 자동으로 차단하는 Linux 도구

iptables

Linux 커널의 패킷 필터 방화벽 — ACCEPT/DROP 규칙 등록

화이트리스트

"허용 목록" — 차단 규칙보다 먼저 평가되어 자기 자신 보호

wrapper

원본 명령을 감싸서 가드/로깅을 추가한 스크립트

사고 #3 · claude CLI v2.1.133 Bun panic (5/8)

용어

SIGSEGV

Segmentation Fault — 잘못된 메모리 접근 시 OS 가 보내는 시그널 (rc=-11)

Bun

JavaScript·TypeScript 런타임 (Claude CLI 내부에서 사용)

rc=-4

return code — subprocess 가 SIGINT 등으로 종료된 상태

롤백

이전 안정 버전으로 되돌리기