프로젝트 분석: 훅 설정 관련 리스크 정리 #1

New Issue

kimminsung · 2026-04-08T11:17:52+09:00

kimminsung commented

2026-04-08 11:17:52 +09:00

PROJECT_ANALYSIS.md 작성 중 발견한 개선 포인트.

리스크

app_key 평문 커밋 — .claude/hooks/aptabase.json에 키가 평문으로 존재. self-hosted라 영향은 제한적이나 외부 공개 시 반드시 분리 필요.
문서 ↔ 실제 파일 불일치 — usage.md와 SKILL.md는 .py 구현을 전제하지만 실제로는 .sh/.ps1 진입점만 존재.
12MB 바이너리 커밋 — claude-common-installer(3).exe가 저장소에 포함. Git LFS 또는 별도 배포 채널 권장.
post-commit 자동 설치 부재 — clone 시마다 install-git-hook.sh 수동 실행 필요.
memory/ 미존재 — README에 명시되어 있으나 실제 디렉터리 없음.

할 일

aptabase.json을 gitignore 처리하거나 .example 템플릿으로 분리
usage.md / SKILL.md를 현재 .sh/.ps1 구조에 맞춰 갱신
대용량 설치 바이너리 저장소 외부로 이동
post-commit 훅 자동 설치 스크립트 또는 onboarding 문서화

`PROJECT_ANALYSIS.md` 작성 중 발견한 개선 포인트. ## 리스크 1. **`app_key` 평문 커밋** — `.claude/hooks/aptabase.json`에 키가 평문으로 존재. self-hosted라 영향은 제한적이나 외부 공개 시 반드시 분리 필요. 2. **문서 ↔ 실제 파일 불일치** — `usage.md`와 `SKILL.md`는 `.py` 구현을 전제하지만 실제로는 `.sh`/`.ps1` 진입점만 존재. 3. **12MB 바이너리 커밋** — `claude-common-installer(3).exe`가 저장소에 포함. Git LFS 또는 별도 배포 채널 권장. 4. **post-commit 자동 설치 부재** — clone 시마다 `install-git-hook.sh` 수동 실행 필요. 5. **`memory/` 미존재** — README에 명시되어 있으나 실제 디렉터리 없음. ## 할 일 - [ ] `aptabase.json`을 gitignore 처리하거나 `.example` 템플릿으로 분리 - [ ] `usage.md` / `SKILL.md`를 현재 `.sh`/`.ps1` 구조에 맞춰 갱신 - [ ] 대용량 설치 바이너리 저장소 외부로 이동 - [ ] post-commit 훅 자동 설치 스크립트 또는 onboarding 문서화

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: kimminsung/workhistory#1