diff --git a/docs/slimming-plan.md b/docs/slimming-plan.md index c024d3c..9edad46 100644 --- a/docs/slimming-plan.md +++ b/docs/slimming-plan.md @@ -1,6 +1,6 @@ -# EJClaw 경량화·최적화 계획 (v2 — 사용자 결정 반영) +# EJClaw 경량화·최적화 계획 (v3 — 사용자 결정 반영 완료) -- 최초 조사: 2026-10-01 (기준 커밋 af28bae), 결정 반영: 2026-10-01 16시 +- 최초 조사: 2026-10-01 (기준 커밋 af28bae), 결정 반영: 2026-10-01 16시, 최종 결정: 2026-10-01 16시 30분 - 번호는 첫 조사 문서와 같다. 빠진 번호는 "제외"로 표시했다. - 상태 표기 - **확정**: 결정이 끝나 바로 진행 @@ -19,16 +19,16 @@ | 5 | Codex 사용량 조회가 구버전·잠금 없이 실행되는 문제 | 확정 (버그) | | 6 | owner 세션을 작업 단위로 새로 시작 | 추천 (효과 가장 큼) | | 7 | 공용 메모리 다이어트 | 추천 | -| 8 | 아무것도 안 바꾼 작업은 리뷰 생략 | **결정 필요** (아래 쉬운 설명) | +| 8 | owner가 "리뷰 필요 없음"을 스스로 표시하면 리뷰 생략 (시스템이 변경 여부를 다시 확인) | 확정 (사용자 제안 방식, 아래 설계) | | 9 | 리뷰 효과 낮은 방을 single로 | 제외 (요청 시에만 전환) | -| 10 | 마무리 턴 비용 줄이기 | **결정 필요** (해결책 3가지) | +| 10 | 마무리 턴 비용 줄이기 | 확정 (C안) | | 11~15 | 폴링·로그·IPC 정리 | 추천 | | 16 | 웹 대시보드·Android·Glasses 전부 삭제 | 확정 | | 18~21, 23, 24, 29 | 안 쓰는 기능·죽은 코드·의존성 삭제 | 추천 | | 22 | `/stop` 등 명령어 → 대화 중 "그만해"로 중단 | 확정 (새 기능으로 교체) | | 25 | DB 마이그레이션 정리 | 추천 (백업 후) | | 26 | 서비스 ID 단일화 | 보류 (위험 높음) | -| 27 | main 방 | **결정 필요** (역할 설명 아래) | +| 27 | main 방 개념과 방 간 관리 기능 삭제 | 확정 ((다)안) | | 28 | 계정 로테이션 단순화 (계정 1개 고정) | 확정 | | 30~35 | 디스크 정리 약 3.3GB | 추천 | | 36 | 런처 이전 버전 설치 파일 삭제 약 10.5GB | 확정 | @@ -68,7 +68,7 @@ | B | 마무리 턴은 유지하되, 거대한 세션 대신 **이번 작업의 owner·리뷰어 답변(최대 6개, 수천 토큰)만 넣은 가벼운 호출**로 정리 | 지금과 같은 정리 형식 | 마무리 1회당 수십만 → 수천 토큰 | | C | A + B 함께: 바로 승인 → A, 수정 있었음 → B | 같음 | 가장 적음 | -- 추천: **C**. 보여지는 최종 답변 형식은 지금과 같고, 비용만 줄어듭니다. +- **결정: C안.** 보여지는 최종 답변 형식은 지금과 같고, 비용만 줄어듭니다. - 참고: 6번(세션을 작업 단위로 새로 시작)을 하면 마무리 턴이 읽는 세션도 작아져서 B의 효과 일부가 자동으로 생깁니다. ### 27. main 방의 역할 @@ -94,7 +94,7 @@ main 방은 "관리자 방"입니다. 코드상 main 방만 할 수 있는 일 | (나) base_all을 main으로 지정 | base_all에서 관리 도구를 정식으로 사용 | 다른 방 예약 작업 관리 등이 도구로 깔끔해짐 | base_all이 공용 메모리를 못 받게 됨(코드 수정 필요). 위험한 관리 도구가 한 방에 열림 | | (다) main 개념과 방 간 기능 삭제 | 관련 코드 제거 | 코드 정리, 지금 실제 사용 방식 그대로 | 방 간 관리 도구는 영구히 없어짐(셸로는 계속 가능) | -- 추천: **(다)**. 지금도 쓰지 않고 있고, 셸로 다 하고 있기 때문입니다. +- **결정: (다)안.** 지금도 쓰지 않고 있고, 셸로 다 하고 있기 때문입니다. --- @@ -134,9 +134,28 @@ main 방은 "관리자 방"입니다. 코드상 main 방만 할 수 있는 일 - 수정: 공통 규칙만 남기고, 프로젝트·운영 내용은 해당 방 메모리나 "필요하면 이 문서를 읽어라" 링크로 옮긴다. - 효과: 호출당 -7~8K 토큰. -### 8. 리뷰 생략 — 위 설명 참고 (결정 필요) +### 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. 마무리 턴 — 위 해결책 참고 (결정 필요) +### 10. 마무리 턴 — C안 확정 (위 표의 C: 바로 승인이면 owner 답변 그대로, 수정이 있었으면 가벼운 정리 호출) - 리뷰어 effort를 xhigh → high로 낮추는 것은 별도로 추천(리뷰 평균 97초 단축 예상). ## C. 실행 자원 (추천) @@ -163,7 +182,7 @@ main 방은 "관리자 방"입니다. 코드상 main 방만 할 수 있는 일 | 24 | 쓰지 않는 의존성, 루트 dist 빌드 | — | 추천 | | 25 | DB 마이그레이션 정리 | 약 -4천 | 추천 (백업 후) | | 26 | 서비스 ID 단일화 | 약 -1천 | 보류 (위험 높음) | -| 27 | main 방 | (다) 선택 시 정리 | 결정 필요 | +| 27 | main 방 개념과 방 간 관리 기능 | 163곳 정리 | 확정 ((다)안) | | 28 | 계정 로테이션을 계정 1개 기준으로 단순화 (Codex 잠금은 유지) | 약 -400~600 | 확정 | | 29 | Codex warmup 설정을 primer로 합침 | 약 -200 | 추천 | @@ -209,14 +228,23 @@ main 방은 "관리자 방"입니다. 코드상 main 방만 할 수 있는 일 | 단계 | 번호 | 내용 | |---|---|---| | 1단계 | 1, 2, 3, 5, 11~15 | 버그 수정 + 폴링·로그 정리 (작은 수정, 바로 효과) | -| 2단계 | 16, 18~21, 22, 23, 24, 28, 29 | 삭제·단순화 일괄 + "그만해" 중단 기능 | -| 3단계 | 6, 7, 10 | 토큰 절감 (세션 교체, 공용 메모리, 마무리 턴) | +| 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. 남은 결정 (3개) +## H. 결정 현황 -1. 8번 리뷰 생략: (가) 하지 않음 / (나) 설명만 한 작업은 생략 -2. 10번 마무리 턴: A / B / C(추천) / 지금 그대로 -3. 27번 main 방: (가) 그대로 / (나) base_all을 main으로 / (다) 개념 삭제(추천) +모든 결정이 끝났다. + +| 번호 | 결정 | +|---|---| +| 8 | owner가 리뷰 필요 여부 표시 + 시스템 재확인 (사용자 제안) | +| 10 | C안 | +| 27 | (다)안: main 방 개념 삭제 | +| 16 | 웹 대시보드·Android·Glasses 전부 삭제 | +| 22 | 명령어 대신 대화 중 "그만해"로 중단 | +| 28 | 계정 1개 기준으로 단순화 | +| 36 | 런처 이전 버전 삭제 | +| 9 | single 전환 안 함 (요청 시에만) |