1. 주문을 직접 내는 것#

AI 판단기는 숫자 몇 개만 돌려줍니다. 호재일 확률, 재료가 오래 갈 확률, 기사가 이 종목과 관련 있을 확률, 찌라시일 확률입니다. 이 숫자가 높아도 주문은 바로 나가지 않습니다. 코드가 정한 진입 조건을 통과하고, 그다음 리스크 검사까지 통과해야 주문이 나갑니다.

AI가 멈추면 새로 사는 것만 멈춥니다. 이미 산 종목의 손절과 익절은 코드가 계속 처리합니다.

2. 얼마나 살지 정하는 것#

가격, 등락률, 수량, 날짜 계산은 전부 코드가 합니다. 언어 모델은 계산을 틀리기 쉽고, 틀려도 그럴듯하게 틀리기 때문입니다. AI에게는 “이 뉴스가 무슨 뜻인가”만 묻습니다.

3. 손실 한도를 바꾸는 것#

손실 한도는 코드에 고정해 두었습니다.

• 한 종목이 3% 떨어지면 바로 팝니다.
• 하루에 계좌가 3% 줄면 그날은 새로 사지 않습니다.
• 한 주에 7% 줄면 매매를 멈춥니다.
• 15% 줄면 전부 멈추고, 제가 직접 풀기 전까지 다시 켜지지 않습니다.
• 한 종목에 계좌의 40%를 넘게 넣지 않고, 동시에 3종목까지만 들고 있습니다.

팀장 AI는 매일 전략의 목표 수익이나 손절 폭을 조정할 수 있습니다. 하지만 위 한도보다 느슨하게는 못 바꿉니다. 전략이 손절을 5%로 잡아도 실제로는 더 촘촘한 3%가 적용됩니다. 허용 범위를 벗어난 제안은 거부되고, 리포트에 “거부됨”으로 남습니다.

4. 열쇠를 보는 것#

증권사 API 키, 공시 API 키, 알림용 주소 같은 비밀값은 AI가 도는 환경에서 아예 지운 채로 AI를 실행합니다. AI에게 넘기는 자료에도 넣지 않습니다. 보여 주지 않으면 실수로 흘릴 일도 없습니다.

5. 기사 속 “강력 매수”에 넘어가는 것#

뉴스에는 “지금 사야 할 종목” 같은 홍보성 문구가 섞여 있습니다. AI는 이런 문장을 읽고 판단이 흔들릴 수 있습니다. 그래서 “이 기사는 찌라시인가”를 따로 묻고, 그 확률이 높으면 다른 점수가 아무리 좋아도 사지 않습니다.

흐름#

1. 수집: DART 공시와 증권사(한국투자증권 KIS Open API) 뉴스 제목을 주기적으로 가져와 중복을 지우고 종목 코드를 붙입니다.
2. 판단기: 한국어 기사를 로컬 LLM(Ollama, qwen3:8b)으로 영어로 번역한 뒤, 로컬 판단 모델(Laya)에 질문 묶음을 한 번에 던집니다. 질문은 방향, 지속성, 관련성, 찌라시 네 가지입니다. 재료의 강도는 AI에게 묻지 않고 규칙으로 정합니다(공시 3, 실적·계약 키워드 기사 2, 그 밖의 기사 1). 시험해 보니 AI가 매긴 강도는 기사마다 거의 같아서 변별력이 없었습니다.
3. 전략 엔진: 전략마다 YAML로 진입 조건, 수량, 청산 규칙을 정의합니다. 판단기를 쓰지 않는 대조군 전략도 하나 같이 돌려서, AI 판단이 실제로 도움이 되는지 비교합니다.
4. 리스크 게이트: 진입 직전에 한도를 검사합니다. 한도표는 변경 불가 dataclass로 두었고, 이 경로의 코드는 AI가 자동으로 고칠 수 없게 “보호 경로”로 지정했습니다.
5. 주문: 멱등 키로 중복 주문을 막고, 응답이 유실된 주문은 다시 내지 않고 체결 조회로 확인합니다. 장부와 증권사 잔고가 다르면 증권사 잔고를 기준으로 맞춥니다.
6. 장부와 리포트: 전략별 가상 장부에 비용을 뺀 손익을 기록하고, 장 마감 후 메일로 리포트를 보냅니다. 경고는 디스코드로 옵니다.
7. 매니저: 장 마감 후 Claude Code를 헤드리스(claude -p)로 실행해 리포트를 읽히고, 전략 파라미터 변경안을 JSON 스키마로 받습니다. 엔진과는 파일과 DB로만 연결되어 있어서 Claude가 응답하지 않아도 매매는 계속됩니다.

모르면 멈춘다 (fail-closed)#

애매할 때 어느 쪽으로 넘어질지를 정해 두었습니다.

• 기준 자산을 모르면 비상 정지로 취급합니다.
• 평균 매입가를 모르면 들고 있지 않고 청산 쪽으로 갑니다.
• data/HALT 파일이 있으면 전부 멈추고, 사람이 해제 명령을 실행해야 다시 돕니다.
• 금지 종목 목록은 제가 파일로 쓰고, 엔진이 60초마다 다시 읽습니다.

리플레이: 수익이 아니라 안전을 보는 시험#

증권사 조회 응답을 날짜별로 그대로 기록해 두고, 그 하루를 다시 재생할 수 있게 했습니다. 시계는 기다리지 않고 바로 다음 시각으로 넘어가고, 판단기는 저장된 응답을 다시 씁니다.

이 재생의 합격 기준은 수익이 아닙니다.

• 예외 없이 끝까지 돌아야 합니다.
• 한도를 넘는 주문이 0건이어야 합니다. 체결마다 한도표와 다시 대조합니다.
• 장부 합계가 맞아야 합니다.

AI가 쓴 코드를 받아들이는 관문#

매니저 Claude는 새 종목 감지 로직을 코드로 제안할 수 있습니다. 이 코드는 사람 검토 없이 반영되지만, 기계 관문을 차례로 통과해야 합니다.

1. 별도 git worktree에서 Claude가 작성합니다. 쓸 수 있는 파일은 플러그인 파일, 그 테스트, 전략 YAML뿐입니다. 셸은 pytest 한 줄만 허용하고, 커밋은 Claude가 아니라 빌더 코드가 합니다.
2. AST 정적 검사로 허용 목록 밖의 import, open, exec, eval, getattr, 이중 밑줄 접근을 거부합니다.
3. 전체 테스트를 돌립니다.
4. 리플레이를 통과해야 main에 병합되고, 디스코드로 알림이 옵니다.

AI가 고칠 수 있는 범위는 “종목을 찾아내는 로직”으로 한정했습니다. 판단, 진입, 청산, 수량, 리스크는 기존 부품을 YAML로 조립하는 것만 허용합니다.

솔직히 적어 둘 한계가 있습니다. 정적 검사는 우회 방법이 나올 때마다 막았습니다(별칭 import, while, del, BaseException 등). 그래도 이건 샌드박스가 아닙니다. 무한 루프나 아주 큰 range 같은 건 정적 검사로 못 막습니다. 그래서 문서에도 “격리가 아니라 매니저 AI의 실수를 막는 장치”라고 적어 두었습니다. 대신 실행 중에 플러그인 호출이 2초를 넘기거나 예외가 나면, 그날 그 전략의 신규 진입을 끕니다.