Files
EJClaw/docs/slimming-plan.md
2026-10-01 16:35:25 +09:00

17 KiB
Raw Permalink Blame History

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번 돌아갑니다.

  1. Claude(owner)가 답을 만든다
  2. Codex(리뷰어)가 그 답을 검토한다 (평균 1분 30초)
  3. 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가 리뷰 불필요라고 표시했고, 안전 조건도 통과하면 바로 끝낸다"는 분기를 넣으면 됩니다.

동작 방식:

  1. owner가 답을 만들 때, 정말 설명·조사만 했고 아무것도 바꾸지 않았으면 답변 끝에 리뷰 불필요: (이유) 한 줄을 붙인다. 애매하면 붙이지 않는다(기본값은 리뷰).
  2. 시스템이 그 표시를 그대로 믿지 않고 다시 확인한다. 아래 중 하나라도 해당하면 표시를 무시하고 평소처럼 리뷰한다.
    • 작업 폴더에 코드 변경이나 커밋이 있음 (이미 있는 hasCodeChangesSinceRef로 확인)
    • 파일을 고치는 도구(Edit, Write 등)를 썼음
    • 셸 명령 중에 무언가를 바꾸는 명령이 있었음: 삭제·이동, 서비스 재시작, 프로세스 종료, DB 쓰기, git 커밋·푸시, crontab 수정, 외부 API 쓰기 요청 등
  3. 통과하면 리뷰어와 마무리 턴 없이 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 전환 안 함 (요청 시에만)