17 KiB
EJClaw 경량화·최적화 계획 (v3 — 사용자 결정 반영 완료)
- 최초 조사: 2026-10-01 (기준 커밋
af28bae), 결정 반영: 2026-10-01 16시, 최종 결정: 2026-10-01 16시 30분 - 번호는 첫 조사 문서와 같다. 빠진 번호는 "제외"로 표시했다.
- 상태 표기
- 확정: 결정이 끝나 바로 진행
- 추천: 결정은 필요 없지만, 진행하겠다고 확인만 받으면 됨
- 결정 필요: 아래 설명을 보고 골라 주셔야 함
- 제외: 하지 않음
0. 한눈에 보기
| 번호 | 내용 | 상태 |
|---|---|---|
| 1 | 중재자가 판정 규칙을 못 받는 버그 수정 | 확정 (버그) |
| 2 | 리뷰어가 owner 규칙을 받는 버그 수정 | 확정 (버그) |
| 3 | 사용자에게 묻는 경우(NEEDS_CONTEXT) 중재 없이 바로 전달 | 확정 (버그) |
| 4·17 | Claude 한도 소진 시 답변이 사라지는 failover 경로 제거 | 확정 (버그) |
| 5 | Codex 사용량 조회가 구버전·잠금 없이 실행되는 문제 | 확정 (버그) |
| 6 | owner 세션을 작업 단위로 새로 시작 | 추천 (효과 가장 큼) |
| 7 | 공용 메모리 다이어트 | 추천 |
| 8 | owner가 "리뷰 필요 없음"을 스스로 표시하면 리뷰 생략 (시스템이 변경 여부를 다시 확인) | 확정 (사용자 제안 방식, 아래 설계) |
| 9 | 리뷰 효과 낮은 방을 single로 | 제외 (요청 시에만 전환) |
| 10 | 마무리 턴 비용 줄이기 | 확정 (C안) |
| 11~15 | 폴링·로그·IPC 정리 | 추천 |
| 16 | 웹 대시보드·Android·Glasses 전부 삭제 | 확정 |
| 18~21, 23, 24, 29 | 안 쓰는 기능·죽은 코드·의존성 삭제 | 추천 |
| 22 | /stop 등 명령어 → 대화 중 "그만해"로 중단 |
확정 (새 기능으로 교체) |
| 25 | DB 마이그레이션 정리 | 추천 (백업 후) |
| 26 | 서비스 ID 단일화 | 보류 (위험 높음) |
| 27 | main 방 개념과 방 간 관리 기능 삭제 | 확정 ((다)안) |
| 28 | 계정 로테이션 단순화 (계정 1개 고정) | 확정 |
| 30~35 | 디스크 정리 약 3.3GB | 추천 |
| 36 | 런처 이전 버전 설치 파일 삭제 약 10.5GB | 확정 |
결정한 3가지 — 설명 (8번은 아래 B절의 확정 설계 참고)
8. "리뷰 생략"이 뭔가요?
지금은 어떤 질문이든 이렇게 3번 돌아갑니다.
- Claude(owner)가 답을 만든다
- Codex(리뷰어)가 그 답을 검토한다 (평균 1분 30초)
- Claude가 최종 정리를 한다 (평균 20초)
그런데 "이 채널 왜 답 안 해?", "main 방 역할이 뭐야?"처럼 파일을 하나도 고치지 않고 설명만 하는 작업이 전체의 약 44%입니다. "리뷰 생략"은 이런 경우에 2·3번을 건너뛰고 1번 답을 바로 보내는 것입니다.
| 지금 | 리뷰 생략 시 | |
|---|---|---|
| 코드를 고친 작업 | 3단계 그대로 | 3단계 그대로 (변화 없음) |
| 설명만 한 작업 | 3단계 (약 2분 더 걸림) | 1단계 (약 2분 빨라짐) |
| 잃는 것 | — | 설명 답변의 사실 오류를 리뷰어가 잡아줄 기회 |
- 참고: 오늘도 리뷰어가 설명형 답변에서 실수를 잡은 적이 있습니다(KAclaw 로그인 미확인 상태로 완료 처리하려던 것). 리뷰 품질을 중시하시면 하지 않는 것을 권합니다.
- 선택지: (가) 하지 않음 / (나) 설명만 한 작업은 리뷰 생략
10. 마무리 턴, 다른 해결책
마무리 턴이 생긴 이유(말씀하신 것): owner와 리뷰어가 서로 대화만 하고, 마지막에 "해결했어요"만 남기는 경우가 많아서 전체를 정리해 보여달라고 하신 것.
지금 문제: 마무리 턴이 owner의 거대한 대화 세션 전체(수십만 토큰)를 다시 읽고 정리합니다. 정리 자체는 몇 천 토큰이면 되는데, 매번 수십만 토큰을 씁니다(30일 178회).
| 안 | 방법 | 결과물 | 비용 |
|---|---|---|---|
| A | 리뷰어가 수정 요청 없이 바로 승인하면, owner의 첫 답변을 그대로 최종 답변으로 보냄 (owner 규칙상 첫 답변도 이미 "사용자용 완결 답변" 형식) | 수정 없이 끝난 작업은 그대로 / 수정이 있었던 작업만 마무리 턴 | 작업의 약 80%에서 마무리 턴 0회 |
| B | 마무리 턴은 유지하되, 거대한 세션 대신 이번 작업의 owner·리뷰어 답변(최대 6개, 수천 토큰)만 넣은 가벼운 호출로 정리 | 지금과 같은 정리 형식 | 마무리 1회당 수십만 → 수천 토큰 |
| C | A + B 함께: 바로 승인 → A, 수정 있었음 → B | 같음 | 가장 적음 |
- 결정: C안. 보여지는 최종 답변 형식은 지금과 같고, 비용만 줄어듭니다.
- 참고: 6번(세션을 작업 단위로 새로 시작)을 하면 마무리 턴이 읽는 세션도 작아져서 B의 효과 일부가 자동으로 생깁니다.
27. main 방의 역할
main 방은 "관리자 방"입니다. 코드상 main 방만 할 수 있는 일은 다음과 같습니다.
| main 방만 가능한 것 | 근거 |
|---|---|
| 다른 방의 예약 작업 보기·취소·일시정지·새로 만들기 | src/ipc-task-processor/tasks.ts, schedule.ts |
채널 등록·설정 변경 도구(assign_room) |
src/ipc-task-processor/rooms.ts |
| 다른 방으로 메시지 보내기 | src/ipc-message-forwarding.ts |
| 전체 방 목록, 모든 방의 DB 기록 조회 | agent-runner-snapshot.ts, db-evidence.ts |
| 트리거 없이 항상 응답, 세션 명령 허용 | message-runtime-rules.ts, session-commands.ts |
| (부작용) 공용 메모리를 받지 않음 | agent-runner-environment.ts:671 |
현재 상황:
- main 방이 하나도 없어서 위 기능은 모든 방에서 꺼져 있습니다.
- 대신 base_all 방에서 셸 명령으로 같은 관리 작업(채널 등록, 다른 방 작업 중단, 서비스 재시작 등)을 해 왔습니다. 에이전트가 호스트 셸을 직접 쓸 수 있어서 main 권한이 사실상 필요 없었습니다.
| 선택지 | 내용 | 장점 | 단점 |
|---|---|---|---|
| (가) 지금처럼 둠 | main 없음, 관리는 base_all에서 셸로 | 변경 없음 | main 관련 코드 163곳이 쓸모없이 남음 |
| (나) base_all을 main으로 지정 | base_all에서 관리 도구를 정식으로 사용 | 다른 방 예약 작업 관리 등이 도구로 깔끔해짐 | base_all이 공용 메모리를 못 받게 됨(코드 수정 필요). 위험한 관리 도구가 한 방에 열림 |
| (다) main 개념과 방 간 기능 삭제 | 관련 코드 제거 | 코드 정리, 지금 실제 사용 방식 그대로 | 방 간 관리 도구는 영구히 없어짐(셸로는 계속 가능) |
- 결정: (다)안. 지금도 쓰지 않고 있고, 셸로 다 하고 있기 때문입니다.
A. 버그 수정 (확정)
1. 중재자가 판정 규칙을 받지 못함
- 근거: 규칙 파일을 읽는 코드가 꺼져 있는 경로(unsafe 모드, MoA)에서만 호출된다. 중재자 세션 폴더에 규칙 파일이 없다.
- 영향: 30일간 중재 23회 중 20회가 판정을 해석하지 못하고 사용자에게 그냥 넘어감.
- 수정: 일반 경로의 중재자 세션에 중재자 규칙을 넣는다.
2. Codex 리뷰어가 owner 규칙을 받음
- 근거: 실제 리뷰어 세션
AGENTS.md에 "You are the owner"가 들어 있다. - 수정: 리뷰어 세션에는 리뷰어 규칙만 넣는다.
3. NEEDS_CONTEXT가 중재자를 거침
- 근거: 중재 23회 중 13회가 이 경우. 중재자 규칙상 항상 사용자에게 넘기는 경우다.
- 수정: 중재 없이 바로 사용자에게 보낸다. 중재 호출 -57% 이상.
4·17. 받을 곳 없는 Claude→Codex failover 제거
- 근거: Claude 한도 소진 시 이 배포에 없는
codex-main으로 작업을 넘긴다. 5월에 넘긴 2건이 아직pending. - 수정: 체인 제거(코드 약 -2천 줄), 한도 소진 시 "한도 소진, ○시 재개 예정"을 바로 보냄.
- 주의: DB 스키마와 엮여 있어 백업 후 진행.
5. Codex 사용량 조회
- 근거: 구버전 전역 Codex(0.128)를 계정 잠금 없이 실행 → 토큰 충돌 위험.
- 수정: 저장소에 고정된 0.159.3 사용 + 계정 잠금 + 주기 5~10분(12번과 함께).
B. 토큰·속도
6. owner 세션을 작업 단위로 새로 시작 (추천, 효과 가장 큼)
- 근거: 방마다 한 세션을 몇 주씩 이어 써서 호출 1회에 중앙값 26만, 최대 100만 토큰을 읽는다. Claude 5시간 사용량 89%의 주원인.
- 수정: 새 작업이 시작되면 세션을 새로 연다. 직전 최종 답변은 이미 자동으로 넘겨주고 있어 맥락 손실이 작다.
- 효과: Claude 입력 토큰 -50~70% (추정).
7. 공용 메모리 다이어트 (추천)
- 근거: 모든 세션에 공용 메모리 약 1.1만 토큰이 들어간다. 세탁기 앱 배포, Windows CI, .5 docker, EJClaw 운영 절차 등 대부분 방과 무관한 내용.
- 수정: 공통 규칙만 남기고, 프로젝트·운영 내용은 해당 방 메모리나 "필요하면 이 문서를 읽어라" 링크로 옮긴다.
- 효과: 호출당 -7~8K 토큰.
8. 리뷰 필요 여부를 owner가 표시 (확정 — 사용자 제안 방식)
가능 여부: 가능합니다. owner 답변 뒤에 무엇을 할지 정하는 곳이 한 군데(src/paired-completion-signals.ts의 resolveOwnerCompletionSignal)라서, 여기에 "owner가 리뷰 불필요라고 표시했고, 안전 조건도 통과하면 바로 끝낸다"는 분기를 넣으면 됩니다.
동작 방식:
- owner가 답을 만들 때, 정말 설명·조사만 했고 아무것도 바꾸지 않았으면 답변 끝에
리뷰 불필요: (이유)한 줄을 붙인다. 애매하면 붙이지 않는다(기본값은 리뷰). - 시스템이 그 표시를 그대로 믿지 않고 다시 확인한다. 아래 중 하나라도 해당하면 표시를 무시하고 평소처럼 리뷰한다.
- 작업 폴더에 코드 변경이나 커밋이 있음 (이미 있는
hasCodeChangesSinceRef로 확인) - 파일을 고치는 도구(Edit, Write 등)를 썼음
- 셸 명령 중에 무언가를 바꾸는 명령이 있었음: 삭제·이동, 서비스 재시작, 프로세스 종료, DB 쓰기, git 커밋·푸시, crontab 수정, 외부 API 쓰기 요청 등
- 작업 폴더에 코드 변경이나 커밋이 있음 (이미 있는
- 통과하면 리뷰어와 마무리 턴 없이 owner 답변이 바로 최종 답변이 된다. 답변 끝에 "검토 생략(변경 없는 설명형 답변)"을 작게 표시하고, 사용자가 "검토해줘"라고 하면 그때 리뷰를 돌린다.
왜 안전한가:
- 오늘 리뷰어가 실수를 잡은 경우(KAclaw 로그인 미확인 상태로 완료 처리)는 서비스 재시작·설정 변경이 있었던 작업이라 2번 조건에 걸려 어차피 리뷰를 받습니다.
- 이 방(base_all)의 최근 세션은 셸 명령 415개 중 77개가 변경 명령이었습니다. 운영 작업은 거의 항상 리뷰를 거치고, 순수 질문·설명만 리뷰를 건너뜁니다.
남는 한계: owner가 설명 내용 자체를 틀리게 말하는 경우(변경 없이 잘못된 정보만 준 경우)는 리뷰어가 못 잡습니다. 그래서 owner가 확신이 없거나 사실 확인이 중요한 답이면 표시하지 않도록 규칙에 넣습니다.
예상 효과: 30일 기준 단순 질답 83건 중 상당수에서 리뷰어(평균 1분 30초)와 마무리 턴(20초)이 빠짐.
9. single 전환 — 제외 (요청하신 방만 전환)
10. 마무리 턴 — C안 확정 (위 표의 C: 바로 승인이면 owner 답변 그대로, 수정이 있었으면 가벼운 정리 호출)
- 리뷰어 effort를 xhigh → high로 낮추는 것은 별도로 추천(리뷰 평균 97초 단축 예상).
C. 실행 자원 (추천)
| 번호 | 내용 | 효과 |
|---|---|---|
| 11 | 대시보드 중복 정리: 2초마다 Discord 메시지 100개 조회 → 시작 시 1회 + 5분 주기 | Discord 호출 하루 4.3만 건 → 수백 건 |
| 12 | Codex 사용량 조회: 1분마다 프로세스 생성 → 5~10분 + 리뷰 직후 | 프로세스 생성 -80~90% |
| 13 | Claude 사용량 조회: 1분 → 5분 | 호출 -80%, 429 오류 거의 0 |
| 14 | 로그 한 줄 출력 + 반복 로그 4종 debug로 | 로그 줄 수 -90% |
| 15 | IPC 고아 폴더 7개 삭제 | 1초 폴링 부담 -20% |
D. 코드 덜어내기
| 번호 | 내용 | 줄어드는 코드 | 상태 |
|---|---|---|---|
| 16 | 웹 대시보드·Android 앱·Glasses·관련 설정/스크립트·의존성(react, vite, playwright 등) | 약 -2.4만 줄 (+테스트 -5.8천) | 확정 |
| 18 | MoA + Kimi 사용량 | 약 -600 | 추천 |
| 19 | auto-paired-mode | 약 -370 | 추천 |
| 20 | 참조 0인 코드 28개 + 고아 파일 3개 | 약 -500 | 추천 |
| 21 | 엉뚱한 계정을 갱신하는 6시간 Codex 갱신 루프 | 약 -150 | 추천 |
| 22 | /compact·/clear·/stop 명령 삭제 → 아래 새 기능으로 교체 |
약 -280 (+테스트 -324) | 확정 |
| 23 | macOS·launchd·nohup 설치 경로, repo-tokens | 약 -150 | 추천 |
| 24 | 쓰지 않는 의존성, 루트 dist 빌드 | — | 추천 |
| 25 | DB 마이그레이션 정리 | 약 -4천 | 추천 (백업 후) |
| 26 | 서비스 ID 단일화 | 약 -1천 | 보류 (위험 높음) |
| 27 | main 방 개념과 방 간 관리 기능 | 163곳 정리 | 확정 ((다)안) |
| 28 | 계정 로테이션을 계정 1개 기준으로 단순화 (Codex 잠금은 유지) | 약 -400~600 | 확정 |
| 29 | Codex warmup 설정을 primer로 합침 | 약 -200 | 추천 |
- 전부 진행하면 운영 코드 약 7.6만 줄 중 약 3만 줄(약 40%) 감소.
22번 새 기능: 대화 중 "그만해"로 작업 중단 (확정)
| 항목 | 설계 |
|---|---|
| 언제 멈추나 | 방에서 작업이 돌고 있을 때 사용자가 중단 의사만 담긴 짧은 메시지를 보내면 |
| 멈추는 말 | "그만", "그만해", "멈춰", "중단", "하지마", "하지 마", "취소", "스톱", "stop" 등 |
| 멈추지 않는 경우 | "그거 하지 말고 이걸 해줘"처럼 다른 지시가 함께 있는 메시지는 방향 수정으로 보고 평소처럼 처리 |
| 멈출 때 하는 일 | ① 그 방에서 돌던 owner·리뷰어·중재자 실행 종료 ② 진행 중이던 작업 종료 처리 ③ 대기 중이던 메시지까지 처리 완료로 표시(지난번 pdf 방처럼 저절로 다시 시작되는 것 방지) ④ "진행 중이던 작업을 중단했습니다"라고 답장 |
| 다시 시작 | 다음에 보내는 메시지부터 평소처럼 새 작업으로 처리 |
| 오작동 방지 | 짧은 메시지만 대상, 판단이 애매하면 멈추지 않고 평소처럼 처리 |
E. 디스크 정리
| 번호 | 대상 | 크기 | 상태 |
|---|---|---|---|
| 30 | DB 백업 23개 중 최근 3개만 남김 | 약 555MB | 추천 |
| 31 | Codex 임시 플러그인 복제본 등 | 약 1.2GB | 추천 |
| 32 | 세션별 Codex 로그 DB | 약 536MB | 추천 |
| 33 | 등록 안 된 방의 폴더 | 약 560MB | 추천 |
| 34 | 리뷰용 임시 폴더 | 약 208MB | 추천 |
| 35 | 30일 지난 작업 첨부 | 일부 | 추천 |
| 36 | 음악퀴즈 런처 release 폴더의 이전 버전 설치 파일 0.4.9~0.4.30 (6종 × 22버전). 최신 1.0.0 설치 파일 6개(474MB)와 win-unpacked는 남김 |
약 10.5GB | 확정 |
| 36-참고 | unifi-site 작업공간의 .venv 7.7GB |
— | 남김 (이전 버전이 아니라 지금 쓰는 개발 환경. 실제 사이트는 /home/claude/unifi-site/.venv를 씀. 지우길 원하시면 말씀해 주세요, 다시 만들 수 있음) |
- 30·31·32·35는 주기적으로 정리하는 cron도 함께 추가(추천).
F. 유지
| 대상 | 이유 |
|---|---|
| Tribunal(owner·리뷰어·중재자) 구조, 방별 모드 | 사용자 결정. 리뷰가 결과를 바꾼 비율 13~16% |
| Discord 상태 대시보드 | 사용량 확인용으로 실제 사용 중 (웹 대시보드와 별개) |
| usage primer, evidence·verification 도구, 재시작 복구 등 안전장치 | 실제 동작 기록 있음 |
| DB 보존 정책 | 37MB, 증가 완만. 당장 불필요 |
G. 진행 순서 (제안)
| 단계 | 번호 | 내용 |
|---|---|---|
| 1단계 | 1, 2, 3, 5, 11~15 | 버그 수정 + 폴링·로그 정리 (작은 수정, 바로 효과) |
| 2단계 | 16, 18~21, 22, 23, 24, 27, 28, 29 | 삭제·단순화 일괄(main 방 포함) + "그만해" 중단 기능 |
| 3단계 | 6, 7, 8, 10 | 토큰 절감 (세션 교체, 공용 메모리, 리뷰 필요 여부 표시, 마무리 턴 C안) |
| 4단계 | 4·17, 25 | DB와 엮인 구조 정리 (백업 후) |
| 5단계 | 30~36 | 디스크 정리 + 주기 정리 cron |
| 보류 | 26 | 서비스 ID 단일화 |
H. 결정 현황
모든 결정이 끝났다.
| 번호 | 결정 |
|---|---|
| 8 | owner가 리뷰 필요 여부 표시 + 시스템 재확인 (사용자 제안) |
| 10 | C안 |
| 27 | (다)안: main 방 개념 삭제 |
| 16 | 웹 대시보드·Android·Glasses 전부 삭제 |
| 22 | 명령어 대신 대화 중 "그만해"로 중단 |
| 28 | 계정 1개 기준으로 단순화 |
| 36 | 런처 이전 버전 삭제 |
| 9 | single 전환 안 함 (요청 시에만) |