docs(claude.md): git 서버 장애 판독·복구 절차 요약 추가 (§15-12)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FVeduv1eNdXjk1ay4tSgBg
This commit is contained in:
songyc macbook 2026-08-02 11:37:58 +09:00
parent 9224b84734
commit c8006b6895

View File

@ -368,4 +368,5 @@ xcrun xcstringstool sync Widgets/Localizable.xcstrings --stringsdata "${widget_f
9. 시뮬레이터 검증 스크린샷은 `xcrun simctl io <sim> screenshot`, 런치 인자는 콜드 스타트로
10. **아이콘 전용 버튼에는 `accessibilityLabel` 필수** (보이스오버가 "버튼"으로만 읽는 것 방지). 여러 요소로 된 셀은 label+value로 한 덩어리 낭독(모음 탭 행동 셀 참고), 타임테이블 블록·점처럼 텍스트 없는 시각 요소는 verbatim 라벨(이름+시각)로
11. **서브 에이전트(Agent/Workflow 병렬 분업) 사용 금지 — 사용자 지시(2026-07-22)**: 병렬 리뷰 에이전트 8개가 세션 한도를 급격히 소모한 전례. 검토·수정·검증 등 모든 작업은 오래 걸리더라도 세션 본체가 직접 수행할 것
12. **"재시작" 루틴 — 사용자 지시(2026-08-02)**: 컨텍스트가 길어지면 사용자가 `/clear`·세션 재시작 후 "재시작"이라고만 말한다. 그러면 별도 프롬프트 없이 다음을 순서대로 수행할 것 — ①이 CLAUDE.md를 처음 보는 것처럼 정독 ②프로젝트 폴더·파일 구조와 코드를 파악해 상세 분석 ③빌드(Debug+Store)·시뮬레이터 실행·자가 검증 인자(§14 `-progressSelfTest`·`-csvImportTest` 등)로 문제 유무 확인 ④검토 완료 보고: 발견 사항 + 현재 프로젝트 상태(버전·다음 예정 작업) + 이후 대기 태세(사용자의 버그 보고·소기능 요청을 받아 수정할 준비)를 정리해 사용자에게 보고
12. **git push 실패·502 = 자가 호스팅 git 서버 장애 (복구 절차, 2026-08-01)**: 원격(ceuak.duckdns.org)은 자가 호스팅 — Proxmox 호스트(192.168.0.5, 웹 UI :8006) 위 **VM 115 `ceuak-debian`(192.168.0.21)이 gitea 본체**(외부 ssh 2522·`git.ceuak.duckdns.org`가 여기로), VM 131(HAOS, 192.168.0.22)의 nginx가 리버스 프록시. 작업 맥은 같은 LAN이라 사용자가 외부에 있어도 진단 가능. **판독**: push 실패 + https 502(nginx 생존) + ping 192.168.0.21 무응답 = VM 115 게스트 프리즈(Proxmox상 "running"이어도 — 2026-08-01 사례는 메모리 92.7% OOM 추정). **복구**: Proxmox API(root@pam — 비밀번호는 저장 안 함, 사용자에게 요청)로 `POST /nodes/prox/qemu/115/status/shutdown`(forceStop=1) → `status/start` → 약 10초 뒤 gitea·ssh 자동 복구 → push 재시도. 재발 방지 적용됨: onboot=1·qemu-guest-agent(API `agent/ping`으로 내부 확인 가능)·스왑 3.0Gi·journald 영속화(다음 프리즈엔 로그 남음). 상세는 아리나 메모리 `haru-git-server-recovery.md`
13. **"재시작" 루틴 — 사용자 지시(2026-08-02)**: 컨텍스트가 길어지면 사용자가 `/clear`·세션 재시작 후 "재시작"이라고만 말한다. 그러면 별도 프롬프트 없이 다음을 순서대로 수행할 것 — ①이 CLAUDE.md를 처음 보는 것처럼 정독 ②프로젝트 폴더·파일 구조와 코드를 파악해 상세 분석 ③빌드(Debug+Store)·시뮬레이터 실행·자가 검증 인자(§14 `-progressSelfTest`·`-csvImportTest` 등)로 문제 유무 확인 ④검토 완료 보고: 발견 사항 + 현재 프로젝트 상태(버전·다음 예정 작업) + 이후 대기 태세(사용자의 버그 보고·소기능 요청을 받아 수정할 준비)를 정리해 사용자에게 보고