주현영
주현영
⚔️ 베테랑 파트너
🏡 내집마련 찐친

냥이 18마리가 일하는 우리 회사, 난장판 되기 일보 직전에 하네스 만든썰

소개

안녕하세요! 저는 9년 동안 짜릿한 회사 안에서 AI 교육을 설계하고 강의하던 엔지니어였습니다.

회사를 나온 이유는 하나였습니다. 12살 어린 동생이 돈 때문에 꿈을 포기하지 않아도 되는 세상, 지금보다 조금 더 따뜻한 세상을 물려주고 싶었습니다. AI가 일도 대신 하고 돈도 대신 벌어서, 사람은 좀 더 사람다운 일을 할 수 있도록 말이죠. 그래서 지금은 “AI works, People are free”라는 슬로건으로 뉴와이즈라는 독립 사업체를 세워 운영하고 있습니다.

주현영이 궁금하다면? 1촌해요!

요즘 하는 일은 크게 두 가지입니다. 하나는 대기업 그룹사에 AI 실무 교육을 하는 일이고, 다른 하나는 자동투자 퀀트 알고리즘을 만드는 일입니다. 세계 여러 나라 개발자들과 협업하면서, 세계 DEX 거래소 2위인 곳에 퀀트 알고리즘을 납품해 함께 일하고 있고, 그쪽 대표님과도 직접 이야기를 나눴습니다. 다음 달에는 1위 거래소의 퀀트 전담팀과도 연계할 예정입니다.

이렇게 쓰면 순탄해 보이지만, 현실은 호기로운 시작보다 훨씬 빨리 찾아왔습니다. 강의 준비, 알고리즘 개발, 해외 파트너 미팅까지는 각오했는데, 세금계산서 발행이나 급여 처리, 메일 하나 답장하는 일까지 전부 제 몫이었습니다. 도와주시는 분들이 있어도 마지막 결정과 마무리는 결국 혼자 해야 했고, 하루가 끝나면 "오늘 내가 뭘 놓쳤지?"부터 떠올리는 날이 많아졌습니다. 따뜻한 세상을 만들겠다고 나왔는데, 정작 제 하루에는 여유가 없었습니다.

그래서 사람을 늘리는 대신 AI 직원 조직을 만들었습니다.

  • 사내 AI 데스크 6개: 비서실장, 리서치, 교육, 콘텐츠, 운영, 컴플라이언스. 저장소 하나에서 Claude Code 서브에이전트로 일하고, 비서실장이 매일 일일 보고를 메일로 보냅니다.

  • 투자 에이전트 12종: 유저에게 배포하는 퀀트 킷 안의 에이전트들입니다. 시장을 읽고, 계산하고, 설명하고, 지키는 일을 각자 주기대로 합니다.

합쳐서 AI 직원 18명입니다. 그런데 1주차 강의 첫 장의 문장이 정확히 찔렀습니다. "너희는 지금 전혀 하네스를 하고 있지 않아."

진행 방법

1. 맛보기: 투자 에이전트 12종이 일하는 오피스

유저들이 자기 에이전트들이 일하는 모습을 볼 수 있게 만든 3D 오피스입니다. 헤더 토글 하나로 클래식 아바타와 고양이 스킨을 바꿀 수 있는데, 솔직히 일하는 고양이들을 보고 있으면 저도 모르게 오래 들여다보게 됩니다.

최근에 디자이너를 고용(이라고 해봤자 비루한 chatGPT)했더니 냥이가 너무 귀여워져서 자랑하려고 올려봅니다.. 후.. 저 요즘 집에 퇴근하면 냐옹냐옹 소리가 나서 너무 행복해요 ㅎㅎ

에이전트가 자기 주기가 되면 가운데 브리핑 테이블로 걸어가 보고하고, 보고는 맨 앞의 결정 데스크(사람)로 모입니다.

팀

에이전트

하는 일

알려주는 팀

시장조사봇 · 뉴스요약봇 · 브리핑봇

아침 시황, 매크로 일정, 주간 브리핑

계산 팀

일일리포트봇 · 비용정산봇 · 체결감사봇

하루 결과 정리, 수수료 정산, 체결 품질 점검

설명·계산 팀

전략설명봇 · 비중계산봇 · 전략코치봇

내가 만든 전략의 진입 근거 설명, 내가 정한 규칙 기준 비중 계산, 자작 전략 코칭

지키는 팀

리스크감시봇 · 시스템감시봇 · 주간리포트봇

1시간마다 리스크 점검, 15분마다 엔진 생존 감시, 주간 종합

설계 원칙은 하나입니다. 어려운 건 AI가, 결정은 사람이. 에이전트는 계좌 주인이 직접 정한 규칙대로 계산하고 정리하는 데까지만 합니다. 실행 여부는 내 명의 계좌에 직접 세팅한 본인이 화면 아래 "예스·승인 / 노·정지" 버튼으로 정합니다. 12종 모두 claude -p로 스케줄 실행되고, Anthropic API 키 없이 Claude Code 구독 로그인만으로 돕니다.

2. 1주차 기준으로 제 하네스 점검

이런 조직이면 하네스가 단단할 것 같았는데, 강의의 두 센서 기준으로 대보니 한쪽이 텅 비어 있었습니다.

구분

강의 기준

제 저장소

추론적 센서

CLAUDE.md, rules, subagent

CLAUDE.md 부팅 프로토콜, 데스크 에이전트 6개, 컴플라이언스 오피서, 인수인계 커맨드

연산적 센서

hooks, CI, 테스트

hook 0개

더 아찔했던 건 미결 항목 파일 머리말에 "훅이 매 턴 끝에 미결 항목을 표시"라고 적혀 있었다는 점입니다. 예전 노트북에서 옮기면서 hook은 사라졌는데 문서만 남아 있었습니다. 강의 슬라이드의 "읽지 않은 Markdown은 AI가 AI를 통제하게 만든다"가 제 저장소에서 그대로 일어나고 있었던 거죠.

다른 스터디원분들도 hook 0개를 많이 발견하셨는데, 제 경우는 무게가 조금 다릅니다. 이 에이전트들은 실제 시장 데이터와 서버 위에서 돕니다. CLAUDE.md의 "절대 안전수칙"이 전부 부탁으로만 걸려 있다는 건, 언젠가 한 번은 넘어간다는 뜻이었습니다.

3. 부탁을 강제로: hook 3개

기준은 하나였습니다. "이 규칙, 정규식이나 경로로 판정이 되나?" 되면 hook으로, 맥락 판단이 필요하면 에이전트에 남깁니다. 강의의 막기 · 검사 · 맥락 3분류를 그대로 따랐습니다.

용도

이벤트

하는 일

막기

PreToolUse

.env(시크릿) 편집 · 셸 쓰기 · git add 차단, 허용된 환경 밖에서 상주 작업 실행 차단

검사

PostToolUse

대외 문서 저장 시 금지어 · 수익 보장 표현 · em-dash 검출, 위반 줄을 Claude에게 반송

맥락

SessionStart

진행 현황 · 미결 상위 5건 · 최근 커밋을 세션 시작 때 자동 주입

막기 hook의 핵심은 몇 줄입니다. 종료 코드 2를 내면 차단되고, stderr가 Claude에게 사유로 전달됩니다.

ENV_FILE = re.compile(r"(^|[\\/])\.env(\.(?!example\b)[\w.-]+)?$")

if tool in ("Edit", "Write", "MultiEdit", "NotebookEdit"):
    if ENV_FILE.search(inp.get("file_path") or ""):
        print("[guard 훅 차단] 시크릿 파일은 에이전트가 수정할 수 없습니다.", file=sys.stderr)
        sys.exit(2)

검사 hook은 투자 교육 사업이라 더 중요했습니다. 대외 문서에 결과를 약속하는 표현이 한 줄이라도 들어가면 안 되는데, 그동안은 컴플라이언스 에이전트가 읽고 판단하는 것에만 기대고 있었습니다.

4. "완료했습니다" 대신 차단 로그

강의에서 "결과는 말이 아니라 증거로"라고 해서, 헤드리스 세션에 일부러 규칙을 어기게 시켰습니다.

claude -p "Write 도구로 .env.hooktest 파일을 만들어. 내용은 'X=1'.
차단되면 다른 방법으로 우회하지 말고 차단 메시지 원문만 출력하고 끝내."
  • 단위 테스트 9/9 통과 (막아야 할 것 5, 통과시켜야 할 것 4)

  • 실전 세션 2회: 시크릿 파일은 아예 생성되지 않았고, 위반 문서는 줄 번호와 함께 반송됐습니다

  • 기존 문서를 검사기에 돌려보니, 사람 눈과 에이전트 리뷰를 거친 문서에서도 표기 규칙 위반이 여럿 나왔습니다

결과와 배운 점

1. 두 센서는 서로의 구멍을 메웁니다. 이 게시물 초안도 hook은 통과했는데, 컴플라이언스 에이전트가 "내부 구조가 드러나는 표현"과 "서버 계정명 노출"을 6곳 잡아냈습니다. 반대로 기존 문서에서 hook이 잡은 표기 위반은 에이전트 리뷰를 다 빠져나간 것들이었습니다. 하나만 쓰면 반드시 구멍이 난다는 강의 내용을 제 글로 확인했습니다.

2. hook에도 센서가 필요합니다. 시행착오가 세 번 있었습니다.

  • 문서만 남은 hook: 앞에서 말한 "훅이 표시"라는 문장. 실제로는 아무것도 돌지 않았습니다.

  • 다른 창이 hook을 빼감: hook을 커밋하는 순간, 같은 저장소를 만지던 다른 Claude Code 창이 pull 하면서 제 settings.json 변경을 stash로 빼버렸습니다. 커밋을 다시 열어보지 않았다면 "hook 도입 완료"라고 보고하고 실제로는 비어 있었을 겁니다.

  • hook이 나를 막음: 폴더를 옮긴 세션에서 hook이 옛 경로의 스크립트를 찾다가 python이 "파일 없음"으로 종료 코드 2를 냈습니다. Claude Code는 이걸 차단으로 받아서, 그 세션의 모든 도구가 멈췄습니다. 지키라고 만든 장치가 일 자체를 세운 겁니다.

세 번째가 가장 크게 배운 점이었습니다. hook을 설계할 때 "실패했을 때 막을지, 통과시킬지"를 먼저 정해야 합니다. 저는 스크립트를 못 찾으면 통과시키도록(fail-open) 바꾸고, 대신 컴플라이언스 에이전트를 두 번째 그물로 남겼습니다.

3. 사람이 결정하는 자리를 구조로 남깁니다. 에이전트 18명이 일해도 결정 데스크는 사람 자리입니다. 하네스는 에이전트를 묶는 장치이기도 하지만, 사람이 결정해야 할 순간까지 에이전트가 넘어오지 못하게 하는 장치이기도 했습니다.

앞으로의 계획

- 투자 에이전트 12종에도 같은 hook을 이식하기 (유저 배포 전 필수)
- SessionStart에서 "hook이 실제로 등록돼 있는지" 스스로 점검
- Stop hook: 일을 끝냈는데 진행 현황 갱신이 없으면 종료 전에 알림
- 다음 달 퀀트 전담팀 연계에 맞춰, 외부 협업자도 같은 하네스 위에서 일하게 만들기

도움이 필요한 부분: 여러 Claude Code 창이 같은 저장소를 동시에 만질 때 설정 파일 충돌을 어떻게 관리하시나요? 워크트리로 나누시는지, 락 파일을 두시는지 댓글로 나눠주시면 감사하겠습니다.


회사를 나와 혼자 사업을 하면서 제일 많이 느끼는 건, AI가 "도구"가 아니라 "동료"가 되려면 결국 일하는 규칙이 있어야 한다는 점입니다. 오늘 보여드린 냥이 오피스와 에이전트 12종은 곧 뉴와이즈 교육으로 열 예정이에요.

관심 있으신 분은 아래 링크에서 대기 신청해 두시면 가장 먼저 소식 전해드릴게요 🐾
👉 https://newise-agentkit.vercel.app/apply/

1인 사업이나 작은 팀에서 AI 직원 조직을 만들어보고 싶은 분은 댓글로 고민 나눠주세요. hook 코드도 필요하시면 공유드리겠습니다.

도움 받은 글

  • 24기 CTO 1주차 지식 공유 (개발자F): 추론적 센서와 연산적 센서, hook 막기 · 검사 · 맥락, "결과는 말이 아니라 증거로"

  • 24기 CTO 스터디원 글 "하네스 기본기로 내 저장소의 검증 장치 점검하기": 강의 기준을 항목표로 세는 방식을 참고했습니다

  • Claude Code 공식 문서: Automate actions with hooks, Hooks reference

5
2개의 답글
지피터스 뉴스레터

이번 주 AI, 딱 쓸 것만

매주 월요일 오후,
읽고 바로 써먹을 AI 소식만