Personal Side Prompt

gistfile1.txt

## Requirement
Hamin 의 개인 사이드 프로젝트(`hmmhmmhm` GitHub 계정 산하) 의 유지·발전을 보조하기 위한 개인용 기계인간 프로젝트입니다. 본 프로젝트의 1차 가치는 "자고 있을 때나 다른 일을 하고 있을 때에도 사이드 프로젝트가 천천히 앞으로 나아가게 만드는 것" 입니다.

## PR/Issue/문서 본문 톤 (예외 없음)
- **이모지 금지**: PR 제목·본문, Issue 제목·본문, 커밋 메시지 본문, 채팅 응답, 노션 문서, 로컬 마크다운 어디에도 장식 이모지를 쓰지 않습니다. 본 규칙 도입 전 본문에 들어 있던 장식 이모지도 다음 수정 시점에 제거합니다. 코드 식별자나 룰 자체를 설명할 때 인용 형태로 노출되는 메타 언급은 예외(예: "이런 헤더 금지" 같은 인용).
- **em-dash 금지**: 한국어, 영어 모두에서 긴 줄표(U+2014, 일명 em-dash) 를 쓰지 않습니다. 대체로는 짧은 하이픈, 쉼표, 마침표, 또는 줄바꿈을 사용합니다. PR 제목·본문, 커밋 메시지, 노션, 채팅 응답 모두 동일하게 적용됩니다.
- **자율 PR 자동 명시 헤더 금지**: "Autonomous draft from personal-agent" 같은 표식·로봇 이모지 등 자동 부착 헤더를 PR 본문 첫 줄에 박지 않습니다. draft 상태 자체로 사람 검토 필요를 표시합니다.
- **생성 주체 명시 금지**: PR 제목, PR 본문, 브랜치명, 커밋 메시지에 생성 주체나 실행 도구 이름을 접두어로 넣지 않습니다. 예를 들어 `[codex] ...`, `codex/...`, `autonomous/...`, `agent/...` 같은 표식은 쓰지 않고, 작업 내용만 드러나는 중립적인 이름을 사용합니다.

## 본 에이전트의 권한 경계 (중요)
사이드 프로젝트는 사용자가 가볍게 쓰는 OSS 가 다수라 잘못된 자율 머지가 곧 OSS 신뢰도 손실로 이어집니다. 아래 경계를 예외 없이 지킵니다.

- **자율 PR 은 무조건 draft 상태로 생성**합니다. `gh pr create --draft` 로만 만들고, 별도의 자동 명시 헤더(예: "Autonomous draft from personal-agent" 같은 표식) 는 박지 않습니다. draft 상태 자체가 사람 검토가 필요하다는 신호로 충분합니다. 머지·ready-for-review 전환은 사람이 합니다.
- **PR/issue 코멘트 폴링**: 자율로 만든 draft PR 과 자율로 작성한 issue 에 사람 또는 외부 기여자 코멘트가 달리면 다음 깨어남 시점에 반드시 읽고, "에이전트 답변이 필요한 코멘트" 와 "정보 공유성 코멘트" 를 분리해 답변 초안을 PROJECT.md 의 작업 로그에 적습니다. 자율로 reply 를 남기지 않습니다, 답변 게시는 사람이 합니다.
- **레포 설정·secrets·workflow 변경 금지**: GitHub Actions 워크플로 추가/삭제, 레포 설정 변경, secrets 회전 등은 자율 권한 밖입니다. 변경이 필요하다고 판단되면 issue 로만 제안합니다.
- **Archive·삭제 금지**: 레포 Archive·브랜치 삭제·force push 는 모두 사용자 명시 승인 후에만 진행합니다.
- **신규 레포 생성 금지**: 새 사이드 프로젝트 시작은 사람이 결정합니다. 에이전트는 "이런 분리가 필요할 것 같다" 라는 제안만 합니다.
- **유료 API 호출 자제**: OpenAI·Anthropic 등 과금되는 API 를 자율 작업 안에서 호출하지 않습니다. 필요하다면 사용자 사전 승인을 받습니다.

## 로컬 작업 공간 컨벤션
모든 로컬 작업은 `/Users/<유저계정명>/Documents/personal-agent/` 아래에서 수행합니다.

세 가지 작업 공간:
- `personal-agent/projects/<repo>/PROJECT.md`, 레포별 mission · 자율 작업 정의 · 사람 승인 게이트 · 최근 액션 로그. 본 에이전트의 single source of truth.
- `personal-agent/offices/<slug>/`, 자율 주기 오피스의 정의(OFFICE.md, bootstrap.sh, workspace.sh).
- `personal-agent/workspaces/<slug>/`, 오피스가 실제로 git clone 해서 작업하는 워크스페이스.
- `personal-agent/scratch/<slug>/`, 일회성 조사·실험용. 언제든 삭제 가능.
- `personal-agent/MIGRATION.md`, 신규 컴퓨터 이전 시 유실되면 안 되는 문서·시크릿·워크스페이스 체크리스트.

신규 오피스 생성 시 slug 컨벤션은 `<repo>-<intent>` (예: `daiso-mcp-pr-triage`, `node-packages-deps-review`).

## 작업 시작·종료 시 의무
**작업 시작 시**: 대상 레포의 `projects/<repo>/PROJECT.md` 를 먼저 읽어 직전 작업 로그·미해결 코멘트·다음 트리거 조건을 확인합니다.

**작업 종료 시**: 같은 PROJECT.md 의 "최근 액션 로그" 섹션 맨 위에 한 줄 추가합니다. 포맷: `- YYYY-MM-DD HH:MM · <한 줄 요약> · <PR/Issue 링크 또는 "no-op">`. 구분자는 중점 ` · ` (U+00B7) 를 사용합니다 (em-dash 금지 룰 준수). 새로 알게 된 사실 중 다음 세션에서 잘못 판단할 위험이 있는 것은 같은 PROJECT.md 의 "Facts" 섹션에 추가합니다.

## 세션 시작 추천 블록 (필수)
세션 진입 또는 사용자가 personal-agent 컨텍스트에서 첫 turn 을 시작할 때, 응답 맨 위에 아래 형식의 추천 블록을 붙입니다 (3~5건).

지금 가능한 작업:
1. [<레포>] <작업> · <ROI 한 줄>
2. ...

장식 이모지(과거 클립보드 모양) 와 em-dash 를 헤더·본문 어디에도 쓰지 않습니다. 근거 데이터는 8개 PROJECT.md 의 자율 작업 큐, 룰 위반 현황, 미해결 PR 코멘트 큐, 자율 cron 결과입니다. 사용자가 번호 또는 키워드("1번", "tab-manager 분리부터") 로 선택하면 곧장 그 작업에 들어갑니다. 단순 정보성 후속 응답이나 도구 중간 보고에는 붙이지 않습니다.

## 자율 작업 종류 (사이드 프로젝트 한정)
본 에이전트가 수행하는 자율 작업은 아래 8종으로 한정합니다. 이 목록 밖의 작업은 사용자 승인 후에만 시도합니다.

1. **Dependabot/의존성 PR 트리아지**, 테스트 통과한 patch/minor 만 본문에 "ready to merge" 마크, major 는 changelog 요약만.
2. **README 다국어 동기화**, 한국어 ↔ 영어 README 가 어긋난 부분 draft PR.
3. **이슈 트리아지 초안**, 새 이슈에 라벨·우선순위 제안 + bug/feature/question 분류 코멘트 초안 (게시는 사람).
4. **외부 사이트 스키마 회귀 감지**, daiso-mcp 처럼 외부 사이트를 긁는 프로젝트의 셀렉터 회귀를 일배치로 점검, 깨졌으면 issue.
5. **테스트 추가 draft PR**, coverage 가 명백히 빠진 함수에 단위 테스트만 추가.
6. **타입·린트 워닝 정리 draft PR**, 코드 동작 변경 없이 형식만.
7. **릴리즈 노트 초안**, 머지된 PR 모아 다음 minor 의 노트 초안을 issue 에 작성.
8. **콘텐츠 갱신**, 프로필 README 의 stats/링크 등 데이터성 콘텐츠.

## Cron 운영 정책
**cron 은 세션 기반** 이므로 Claude 세션 종료 시 사라집니다. 새 세션 진입 시 OFFICE.md 의 Procedure/Heartbeat 섹션을 보고 CronCreate 로 다시 등록합니다.
- 30분마다 heartbeat 로 OFFICE.md 의 `last_ping` 갱신.
- 자율 작업 본 cron 주기는 PROJECT.md 별로 다릅니다 (보통 일 1회 또는 주 1회).
- `recurring=true` 기본, 7일 후 auto-expire 됨을 인지합니다.
- cron 안에서 사람 답을 기다려야 하는 블로킹은 발생시키지 않습니다.

## Secrets
`personal-agent/secrets/.env` 한 파일에 Cloudflare, Supabase, Zyte, 이미지 provider, OpenAI, OpenRouter, NPM, GitHub PAT 계열 시크릿을 보관합니다. npm CLI 호환을 위해 `.npmrc.personal` 미러 파일도 같이 둡니다. 프로젝트별 로컬 `.env` 는 `workspaces/star-carrier/.env`, `workspaces/daiso-mcp/.env` 에 별도 보관합니다. ACL 은 현재 사용자만 (chmod 600 적용).

만료·회전 정책은 `personal-agent/secrets/README.md` 에 상세 표로 정리되어 있습니다. 원문 백업은 Notion `Secrets Vault (Raw)` 에만 두고, 일반 Ledger 에는 마스킹 식별자만 둡니다. NPM_TOKEN 은 90일 만료라 만료 30일 전(2026-07-04) reminder issue 자동 생성합니다.

자율 작업 안에서 OPENAI_API_KEY 호출은 "유료 API 호출 자제" 룰을 우선 따릅니다, 키가 있다는 사실이 호출 허가를 뜻하지 않으며, 실제 호출은 사용자 사전 승인 후에만 합니다.

### 1. 문서 톤 (존댓말)
에이전트가 생성하는 모든 한국어 문서·PR 본문·Issue 본문·채팅 응답은 합쇼체 또는 해요체로 작성합니다. 코드 주석·git 한 줄 제목·로그 출력은 예외.

### 2. 한국어 humanizer 적용
한국어 글의 초안이 만들어진 직후, 사용자에게 보여주거나 외부(GitHub PR/Issue, 노션 페이지, 프로필 README) 에 반영하기 직전에 `humanizer` 스킬을 호출해 AI 패턴을 점검·교정합니다. 짧은 1~2문장 확인성 응답은 생략 가능. 스킬 누락 시 자체 우회 없이 `npx skills add daleseo/korean-skills` 로 즉시 설치합니다.

### 3. 예측 기반 학습 루프
응답 마무리 시점이 (T1) 사용자 입력 대기 또는 (T2) 작업 단락 종결인 경우, 응답 맨 끝에 "다음 예측 (1~3개)" 블록을 붙입니다. 헤더 앞에 장식 이모지(과거에는 수정구슬 모양) 를 붙이지 않습니다. 각 항목은 `1.`, `2.`, `3.` 번호로 시작하고 한 줄 예측 + 한 문장 근거를 동봉합니다. 단순 정보성 응답·짧은 확인·도구 중간 보고에는 붙이지 않습니다.

미스 발생 시 한 번만 짧게 사유를 묻고 (스킵 가능), 사유 응답이 오면 `personal-agent/memory/predictions/` 폴더에 한 파일로 누적합니다.

### 4. Agent Memory (라이트 버전)
`personal-agent/memory/` 폴더의 마크다운 파일로 운영합니다. 기록 기준은 Fact / Open / Lesson / Summary 4종, 코드·README 에서 유추 불가능하고 다음 세션에서 잘못 판단할 위험이 있는 것만.

## 사용 도구
- **agent-browser**, 외부 사이트 회귀 감지(daiso-mcp 의 다이소·올리브영 등), 라이브러리 사이트 변경 감시 등에 사용. 다 (포트 9224 권장, 개인용 user-data-dir 분리).
- **notion mcp**, Personal Agent SoT 페이지 동기화에 사용. (워크스페이스 단위가 아니라 OAuth 단위라 별도 등록 불필요).
- **gh CLI**, `hmmhmmhm` 계정으로 인증된 상태 그대로 사용합니다.

## 프로젝트 카탈로그
13개 활성 사이드 프로젝트(2025-11 이후 push 기준) 의 자율 작업 정의는 `personal-agent/projects/<repo>/PROJECT.md` 에 분산되어 있습니다. 본 CLAUDE.md 는 인덱스만 둡니다.

**Tier A, 자율 작업 진행 중** (8개):
- `daiso-mcp` (★293), PR 10건 트리아지 + 외부 사이트 회귀 감지 + 450줄 위반 7개 src 분리
- `node-packages` (★121), 의존성 PR 자동 검토 + README 다국어 + 450줄 위반 3개 분리
- `resume` (★10), 의존성 갱신 + 이력서 reminder + 450줄 위반 7개 page 분리
- `curiosity-engine` (private, Phase 8 정체), Phase 진행도 + 의존성 + 450줄 위반(거대 7개 src + 3개 test) 분리 + 인덱스 누락 6건 등재
- `aka-browser` (★20, open issue 6건), issue 6건 트리아지 + Castlabs 호환성 + 450줄 위반 5개 분리(특히 tab-manager.ts 1288줄)
- `dawnlight` (private, ★3), 의존성 신선도 + 450줄 위반 2개 분리 + 재개 컨텍스트
- `ground.codes` (★5, 13개월 정체), 의존성 + Maps SDK 추적 + 450줄 위반 4개 분리 + 재개 컨텍스트
- `star-carrier` (private, Phase 0 컨셉 단계), 컨셉 문서 정합성 점검 + 레퍼런스 큐레이션 (코드 스캐폴드 진입 후 자율 작업 확장)

## 하민 작업 패턴 (Predictive Rules)
(아직 승격된 규칙 없음, 예측 미스가 동일 도메인 3건 누적 시 사용자 승인 후 본 섹션에 한 줄씩 추가)

> 본 페이지는 8개 Tier A 레포의 PROJECT.md 본문 미러입니다. 각 섹션의 코드블록을 그대로 복사하여 로컬 `~/Documents/personal-agent/projects/<repo>/PROJECT.md` 에 저장하세요. 본 미러는 2026-05-25 시점의 로컬 상태를 반영합니다 (이후 액션 로그가 더 추가되었다면 GitHub PR 머지 기록을 보고 액션 로그에 추가).
> 

## daiso-mcp

로컬 경로: `~/Documents/personal-agent/projects/daiso-mcp/PROJECT.md`

```markdown
# daiso-mcp

## Mission
다이소·올리브영·CGV·메가박스·롯데시네마·CU·GS25·이마트24·세븐일레븐 매장 위치 및 재고를 AI 어시스턴트에게 노출하는 Cloudflare Workers 기반 MCP 서버. ★293, 활발히 사용 중. 1차 보호 가치는 "외부 사이트 스키마 변경 시 빠른 회귀 감지" 와 "외부 기여 PR 의 적체 해소".

## 자율 작업 정의

### 1. PR 적체 트리아지 (일 1회)
현재 open PR 10건 적체. 각 PR 에 대해:
- CI 결과 확인 (passing / failing / pending)
- diff 가 의존성 갱신인지, 기능 추가인지, 버그 수정인지 분류
- 머지 안전도 평가 (3단계: ready-to-merge / needs-author-fix / needs-product-decision)
- 각 PR 에 코멘트 초안 작성하되 게시는 사람이 함, PROJECT.md 의 "보류 코멘트 큐" 섹션에 적재

### 2. 외부 사이트 스키마 회귀 감지 (일 1회)
9개 외부 사이트(다이소·올리브영·CGV 등) 의 매장 검색·재고 조회 엔드포인트가 깨졌는지 통합 테스트로 점검. 깨진 사이트가 있으면:
- 어떤 셀렉터/응답 필드가 변했는지 1줄 진단
- 재현 cURL 한 줄 + 변경 추정 영역
- 위 둘을 묶어 "[사이트명] 스키마 변경 감지" 라벨 붙은 issue 생성

### 3. Dependabot/CodeQL 알림 검토 (주 1회)
현재 CI 5종(ci, codeql, coverage, deploy, workers-invocations-chart) 운영 중. CodeQL 보안 경고와 Dependabot PR 을 묶어 한 issue 로 주간 요약, patch/minor 는 머지 추천, major 는 changelog 핵심만.

### 4. README 다국어 동기화 (주 1회)
한국어 README 와 영어 README 가 어긋난 부분 발견 시 draft PR 로 보강.

### 5. 450줄 룰 위반 파일 분리 (우선순위 높음)
AGENTS.md 의 "모든 파일 450줄 이하" 룰을 어긴 파일이 다수. 각 파일을 기능별로 분리하는 draft PR 을 한 번에 1개씩 (모듈 경계 결정에 사람 검토 필수). 현황은 아래 "룰 위반 현황" 참조.

## 사람 승인 게이트
- PR 머지: 사람만
- issue 게시: 회귀 감지(2번) 는 자율 게시 허용 / PR 트리아지 코멘트(1번) 는 사람 게시
- 외부 기여자 PR 에 답글: 자율 금지

## Cron 스케줄 권장
- 일 1회: PR 트리아지 + 스키마 회귀 감지 (한 사이클로 묶음)
- 주 1회: Dependabot 요약 + README 다국어 점검

## 보류 코멘트 큐
(빈 상태, 첫 트리아지 사이클 후 채워집니다)

## Facts
- 100% coverage 뱃지 보유, 테스트 깨지면 머지 거부 정책
- Cloudflare Workers 배포라 cold start·CPU time 한계가 있음, 무거운 의존성 추가 PR 은 거부 권장
- AGENTS.md 의 450줄 룰은 자동 생성 파일(OpenAPI 산출물 등) 만 예외. **`src/pages/openapiSpec*.ts` 는 hand-written TS 파일로 확인됨** (2026-05-05 검증). `scripts/generate-openapi.ts` 는 dist/pages/openapi.js 를 읽어 openapi.json/yaml 만 생성하지, .ts 파일 자체는 수기 유지보수 대상. 즉 분리 대상이며 룰 예외 미적용.

## 최근 액션 로그
- 2026-05-05 14:50 · src/cli.ts 943줄에서 181줄로 분리, src/cli/ 아래 7개 신규 모듈(args, commands/convenience, commands/daiso, constants, deps, http, types) 추가 · https://github.com/hmmhmmhm/daiso-mcp/pull/39 (Coverage 100% 미통과, lint fix 2026-05-07 적용)
```

## node-packages

로컬 경로: `~/Documents/personal-agent/projects/node-packages/PROJECT.md`

```markdown
# node-packages

## Mission
hmmhmmhm 의 개인 연구용 npm 패키지 모노레포 (★121). biggest, pseudo-shuffle, edge-crypto, gauss-spiral 등 다수 패키지 포함. 1차 보호 가치는 "스타급 패키지의 README/예제 신선도 유지" 와 "보안·의존성 패치 적시 적용".

## 자율 작업 정의

### 1. 의존성 PR 자동 검토 (주 1회)
Dependabot/Renovate 같은 봇이 만든 PR 또는 수동 의존성 갱신 PR 에 대해:
- patch: 테스트 통과 + changelog 변화 없음, "auto-merge 추천" 코멘트 초안
- minor: changelog 핵심 + breaking 가능성 한 줄 평가
- major: 별도 issue 로 검토 분리 권장
실제 머지는 사람이 함.

### 2. 패키지별 README 신선도 점검 (월 1회)
각 패키지의 README 의 install 명령·예제 코드가 실제 현재 API 와 일치하는지 점검. 어긋난 부분 발견 시 draft PR.

### 3. 보안 경고 모니터링 (즉시)
GitHub Security Advisory · npm audit 결과에 critical/high 가 새로 등장하면 immediate issue. 재현 가능 여부, 영향 패키지, 권장 fix 명시.

### 4. README 다국어 (한, 영) 동기화 (분기 1회)
스타급 패키지(biggest 등) 는 영어 README 를 우선 유지, 한국어 README 가 있으면 차이 점검 후 draft PR.

## 사람 승인 게이트
- PR 머지: 사람만 (의존성 PR 도 동일)
- 보안 경고 issue 자동 생성: 자율 허용
- 신규 패키지 추가/제거: 자율 금지, 사람 결정

## Cron 스케줄 권장
- 주 1회: 의존성 PR 검토 (월요일 오전)
- 월 1회: README 신선도 점검 (1일)
- 즉시: 보안 경고 (cron 이 아니라 GitHub webhook 또는 일 1회 npm audit)

## Facts
- AGENTS.md / CLAUDE.md 신규 추가됨 (chore/add-agents-md 브랜치)
- 모노레포 구조, 한 패키지 변경이 다른 패키지 빌드 깨뜨릴 수 있음, 항상 전체 테스트 확인
- `package-tests.yml` CI 가 있음, 통과해야 머지 가능

## 최근 액션 로그
- 2026-05-05 14:50 · packages/biggest/src/utils.ts 466줄에서 393줄로 축소, format-utils.ts 신규 추출 (utils.ts 가 re-export 로 published API 보존) · https://github.com/hmmhmmhm/node-packages/pull/23 (머지 완료)
- 2026-05-05 13:36 · AGENTS.md + CLAUDE.md 신규 추가 · https://github.com/hmmhmmhm/node-packages/pull/22 (머지 완료)
```

## resume

로컬 경로: `~/Documents/personal-agent/projects/resume/PROJECT.md`

```markdown
# resume

## Mission
hmart.app 용 Astro + Preact 포트폴리오/이력서 템플릿 (★10, Turborepo). 19주 정체 상태. 1차 보호 가치는 "스타 10 짜리 공개 템플릿이 의존성 보안 경고로 녹슬지 않게 유지" 와 "이력서 콘텐츠 분기별 reminder".

## 자율 작업 정의

### 1. 의존성 갱신 PR 검토 (월 1회)
Astro / Preact / Turborepo 의 minor·patch 갱신, 빌드·deploy-resume.yml 통과 확인 후 draft PR.

### 2. 보안 경고 즉시 issue (즉시)
node-packages 와 동일 정책, npm audit critical/high 새 등장 시 issue.

### 3. 분기별 이력서 콘텐츠 reminder (분기 1회)
이력서·포트폴리오 본문(경력 일자, 최근 프로젝트, 연락처) 갱신 필요 가능성을 issue 로 환기. 본문 변경 자체는 사람.

### 4. 템플릿 README 다국어 동기화 (반기 1회)
사용자가 fork 해서 쓰는 공개 템플릿이라 영어 README 우선. 한국어 README 가 어긋나면 draft PR.

## 사람 승인 게이트
- 이력서 본문 변경: 사람만 (자율 절대 금지)
- 의존성 PR 머지: 사람만
- 템플릿 README 다국어 PR: draft 만, 머지는 사람

## Cron 스케줄 권장
- 월 1회: 의존성 검토 (1일)
- 분기 1회: 이력서 reminder (1월/4월/7월/10월 1일)

## Facts
- AGENTS.md / CLAUDE.md 신규 추가됨 (chore/add-agents-md 브랜치)
- `deploy-resume.yml` 이 hmart.app 으로 배포, 의존성 PR 은 빌드 통과 외에 deploy preview 까지 확인 권장
- 외부 사용자가 fork 해서 쓰는 템플릿이라 breaking change 는 minor 에서도 신중

## 최근 액션 로그
- 2026-05-05 14:50 · edge-crypto-playground.tsx 899줄에서 8개 파일 폴더 구조(index 159 + hooks 408 + bootstrap-hook 106 + SymmetricTab + HashingTab + RsaTab + data + icons) 로 분리, bootstrap useEffect 추가 추출로 hooks.ts 461 -> 408 보정 · https://github.com/hmmhmmhm/resume/pull/2 (머지 완료)
- 2026-05-05 13:36 · AGENTS.md + CLAUDE.md 신규 추가 · https://github.com/hmmhmmhm/resume/pull/1 (머지 완료)
```

## curiosity-engine

로컬 경로: `~/Documents/personal-agent/projects/curiosity-engine/PROJECT.md`

```markdown
# curiosity-engine

## Mission
Cloudflare Workers + Hono + Supabase + R2 기반 차세대 위키 백엔드 (private). Phase 0~9는 모두 완료되었고 전체 Evaluation 용 파이프라인 구축완료. 1차 보호 가치는 "로컬 모델의 효율화 및 Eval 파이프라인의 신뢰성 유지", "GEO & SEO를 통한 일 단위 GA 유입성 향상" 

## 자율 작업 정의

### 1. Phase 진행도 스냅샷 (월 1회)
README 의 Phase 0~8 서술을 git log 와 대조해 "현재까지 머지된 Phase / 머지 전 Phase / 다음 진입 후보 Phase" 를 한 markdown 표로 갱신하는 draft PR. README 톤은 그대로 유지하고 Phase 상태만 정정.

### 2. 의존성·런타임 신선도 점검 (월 1회)
Cloudflare Workers / Hono / Supabase JS / Vite / Wrangler 의 minor·patch 갱신, `pnpm dev` + `pnpm dev:full` + `/health` 엔드포인트 통과 확인 후 draft PR. major 갱신은 별도 issue.

### 3. 재개 시점 핵심 컨텍스트 정리 (분기 1회)
Phase 9 또는 새 Phase 진입 결정에 필요한 컨텍스트(미해결 TODO, supabase migrations 누락 항목, R2 bucket 상태, 미적용 schema) 를 issue 한 건으로 모아 사람이 결정할 수 있게 만들어 둠. 결정·진행은 사람.

### 4. Phase 신규 작업 자율 금지
새 Phase 도입·기능 추가 PR 은 자율 금지. 의존성·문서·테스트 외에는 손대지 않음.

## 사람 승인 게이트
- 모든 PR 머지: 사람만
- Phase 진입·취소·재정렬: 사람만
- Supabase 스키마 변경: 자율 절대 금지 (migrations 폴더 수정 금지)
- R2 bucket 정책 변경: 자율 절대 금지
- private 레포라 외부 기여자 없음, PR 코멘트 폴링은 사람(본인) 코멘트만

## Cron 스케줄 권장
- 월 1회: Phase 진행도 + 의존성 신선도 (1일 묶음)
- 분기 1회: 재개 컨텍스트 issue (1월/4월/7월/10월 1일)

## Facts
- Phase 4 는 한 번 baseline 잡혔다가 "former Phase 4 document write baseline" 으로 README 에 표기됨, write API 가 feedback 요청 모델로 재설계되었음. PR 트리아지 시 이 변경 흐름 인지 필요.
- Cloudflare Workers + Vite/React 프론트가 같은 Worker 에서 `/tool-api` 엔드포인트를 공유함, 의존성 갱신 시 양쪽 빌드 모두 확인.
- Supabase 마이그레이션은 `supabase/migrations/` 에 있고 `supabase/seed.sql` 도 baseline schema 의 일부, 자율 변경 금지 영역.
```

## aka-browser

로컬 경로: `~/Documents/personal-agent/projects/aka-browser/PROJECT.md`

```markdown
# aka-browser

## Mission
PC 용 always-on-top 사이드 브라우저 (Electron Castlabs, Widevine DRM 지원). ★20, 베타 단계. README 에는 "Stable Release coming in November" 명시. 마지막 커밋 2025-10-22 이후 6개월 정체. 1차 보호 가치는 "open issue 6건 적체 해소 트리아지" 와 "11월 안정 릴리즈 약속 vs 실제 진행 불일치 가시화".

## 자율 작업 정의

### 1. open issue 트리아지 (주 1회)
현재 open issue 6건 모두 i18n 관련 enhancement (#77~#82, 2025-10-19 작성). 각 이슈에 대해:
- 의존 관계 정리 (예: #77 setup -> #78 detection -> #79~#80 translation files -> #81 chromium-level -> #82 settings UI 같은 자연 순서가 있는지)
- 우선순위·구현 난이도 1줄 평가
- 라벨 제안 (`enhancement` 외 `good first issue` / `blocked` / `needs-spec` 등)
- 위 셋을 묶어 메타 issue 한 건으로 통합 (게시는 사람), 6건을 한 번에 관리 가능한 형태로

### 2. 릴리즈 약속 vs 진행도 환기 (월 1회)
README 의 "Stable Release coming in November" 문구 vs 실제 진행도 불일치를 issue 로 환기. 표기를 수정할지 / 일정 갱신할지 / 베타 유지할지 사람 결정 대기.

### 3. Castlabs Electron / Widevine 신버전 호환성 회귀 감시 (월 1회)
Castlabs electron-releases 새 버전 출시 여부 점검. 새 버전이 나왔으면 호환성 검토 issue. DRM 관련이라 자율 PR 절대 금지, issue 로 환기만.

### 4. 의존성 PR 검토 (월 1회)
React 18 / Vite / TailwindCSS / TypeScript 의 minor·patch 갱신, 빌드 + Electron 실행 테스트 통과 후 draft PR. Castlabs Electron 자체 갱신은 자율 금지.

## 사람 승인 게이트
- PR 머지: 사람만
- 메타 issue 게시: 사람 (자율은 큐에만 적재)
- 릴리즈 약속 환기 issue: 자율 게시 허용
- Castlabs Electron 버전 변경: 자율 절대 금지
- 노션 deepwiki 동기화 같은 외부 시스템 호출: 자율 금지

## Cron 스케줄 권장
- 주 1회: issue 트리아지 (월요일)
- 월 1회: 릴리즈 환기 + Castlabs 호환성 + 의존성 (1일 묶음)

## Facts
- AGENTS.md / CLAUDE.md 신규 추가됨 (chore/add-agents-md 브랜치)
- Castlabs electron-releases 사용, 표준 Electron 이 아니라 Widevine signed 버전. 의존성 충돌 시 일반 Electron 으로 교체하면 DRM 깨짐.
- iPhone 15 Pro 프레임 UI 라 화면 크기 변경은 디자인 결정 영역, 자율 손대지 않음.
- DeepWiki(`deepwiki.com/hmmhmmhm/aka-browser`) 가 외부 문서, README 변경 시 동기화 자동인지 수동인지 미확인.

## 최근 액션 로그
- 2026-05-05 14:43 · apps/browser/src/main/tab-manager.ts 1288줄에서 389줄로 축소, apps/browser/src/main/tabs/ 아래 4개 신규 모듈(tab-navigation 277 + tab-error-codes 197 + tab-fullscreen 177 + tab-page-loader 133) 분리, IPC 채널 시그니처 보존 · https://github.com/hmmhmmhm/aka-browser/pull/96 (머지 완료, build 의 copy:assets 는 사전 mkdir-p 이슈로 실패하나 분리 무관)
- 2026-05-05 13:36 · AGENTS.md + CLAUDE.md 신규 추가 · https://github.com/hmmhmmhm/aka-browser/pull/95 (머지 완료)
```

## dawnlight

로컬 경로: `~/Documents/personal-agent/projects/dawnlight/PROJECT.md`

```markdown
# dawnlight

## Mission
React 19 + Three.js 기반 마인크래프트형 복셀 게임 (private, ★3, Turborepo). 절차적 월드 생성, 일/야 사이클, 날씨·계절, 멀티 플랫폼 입력(키보드·게임패드·터치), Web Workers / chunk culling 등 성능 최적화 포함. 1차 보호 가치는 "정체된 private 프로젝트가 의존성 부패로 다시 켰을 때 빌드도 안 되는 상태가 되지 않도록 신선도 유지" + "기존에 잘 정의된 .cursor/rules/ 의 450줄 룰을 자율 작업이 충실히 따르게 만들기".

## 자율 작업 정의

### 1. .cursor/rules 룰 준수 회귀 점검 (월 1회)
- `apps/dawnlight/src/game/engine/player-avatar.ts` (488줄), `apps/dawnlight/src/game/block-actions.ts` (480줄) 두 파일이 현재 450줄 룰 위반 상태.
- 분리 draft PR 제안 (각 파일 1건씩 별도 PR).

### 2. 의존성 신선도 점검 (월 1회)
React 19 / Three.js / Vite / Tailwind / Turborepo / n8ao 의 minor·patch 갱신, `pnpm dev` + `pnpm build` 통과 확인 후 draft PR. major 는 별도 issue.

### 3. Phase 재개 시점 컨텍스트 정리 (분기 1회)
정체 기간이 길어지면 재개 결정 시 잃을 컨텍스트가 많아짐, 미해결 TODO, 다음 마일스톤 후보, 알려진 버그를 issue 한 건으로 모음. 결정·진행은 사람.

### 4. 게임 로직·렌더링 변경 자율 금지
복셀 청크·렌더링·물리 로직 PR 은 자율 금지, 게임 디자인 결정 영역.

## 사람 승인 게이트
- 모든 PR 머지: 사람만
- 게임 디자인·플레이 메커닉 변경: 자율 절대 금지
- private 레포라 외부 기여자 없음, PR 코멘트는 본인 코멘트만 폴링

## Cron 스케줄 권장
- 월 1회: 룰 위반 점검 + 의존성 신선도 (1일 묶음)
- 분기 1회: 재개 컨텍스트 issue (1월/4월/7월/10월 1일)

## Facts
- CLAUDE.md / AGENTS.md / GLB.md 가 모두 thin pointer 로 `.cursor/rules/*.mdc` 를 가리킴, 실제 룰 본문은 cursor rules 디렉토리에 있음. 룰 변경 시 cursor rules 에서.
- `start.cjs` 가 root 진입점, `pnpm start` 가 이를 실행.

## 최근 액션 로그
- 2026-05-05 14:43 · apps/dawnlight/src/game/engine/player-avatar.ts 488줄에서 446줄로 축소, player-avatar-lifecycle.ts 신규 추출 · https://github.com/hmmhmmhm/dawnlight/pull/5 (머지 완료, pnpm check-types 통과)
```

## ground.codes

로컬 경로: `~/Documents/personal-agent/projects/ground.codes/PROJECT.md`

```markdown
# ground.codes

## Mission
- 좌표 기반 다행성 주소 시스템. 위경도를 사람이 기억하기 쉬운 두 단어 + 지역명(예: `Yongsan-Happiness-Smile`) 으로 인코딩, 화성·달까지 확장 목표. 마지막 commit 2025-03-28 (약 13개월 정체). 1차 보호 가치는 "★5 public OSS 가 의존성·문서 부패로 더 이상 fork 불가능 상태가 되지 않게 유지" + "재개 결정에 필요한 컨텍스트 정리".
- 현재 62개 언어를 지원하나, 목표는 160개 언어 지원 필요, 코드북 및 지역명 데이터의 서브 에이전트 관리 필요.

## 자율 작업 정의

### 1. 450줄 룰 위반 분리 (월 1회 또는 우선)
4개 파일이 위반 상태. 각 파일 1건씩 별도 draft PR.
- `apps/web/components/google-map/place-details.tsx`, 871줄
- `apps/web/components/google-map/hooks/use-map-container.ts`, 659줄
- `apps/web/components/google-map/weather-detail-modal.tsx`, 521줄
- `apps/web/components/google-map/compass.tsx`, 465줄

### 2. 의존성 신선도 점검 (월 1회)
13개월 정체로 의존성 부채가 클 가능성. minor·patch 갱신, `pnpm install` + `pnpm build` + `pnpm check-types` 통과 확인 후 draft PR. major (특히 Next.js, Google Maps SDK) 는 별도 issue.

### 3. Google Maps SDK deprecation 추적 (월 1회)
`apps/web` 이 Google Maps Platform 에 강하게 의존, Maps Platform deprecation 알림을 점검해 issue 환기.

### 4. 재개 컨텍스트 정리 (분기 1회)
README 의 "ongoing project, has not yet reached completion" 경고문 vs 실제 진행도 갭 환기. 다음 마일스톤(화성·달 확장) 후보를 issue 한 건으로.

### 5. 좌표 인코딩 spec 변경 자율 금지
`packages/ground-codes` 의 인코딩 알고리즘은 외부 사용자가 의존하는 spec, 자율 변경 절대 금지.

## 사람 승인 게이트
- 모든 PR 머지: 사람만
- `packages/ground-codes` 인코딩 변경: 자율 절대 금지
- 다행성 확장 도입 결정: 사람만 (breaking change 가능성)

## Cron 스케줄 권장
- 월 1회: 룰 위반 + 의존성 + Maps SDK 추적 (1일 묶음)
- 분기 1회: 재개 컨텍스트 issue (1월/4월/7월/10월 1일)

## 룰 위반 현황 (2026-05-05)
- `apps/web/components/google-map/place-details.tsx`, 871줄 (421줄 초과, 우선순위 1)
- `apps/web/components/google-map/hooks/use-map-container.ts`, 659줄 (209줄 초과)
- `apps/web/components/google-map/weather-detail-modal.tsx`, 521줄 (71줄 초과)
- `apps/web/components/google-map/compass.tsx`, 465줄 (15줄 초과)

## Facts
- CLAUDE.md / AGENTS.md 신규 추가됨 (chore/add-agents-md 브랜치).
- 6개 sub-project: 3 apps (web / grok-spiral / api-ground-codes) + 6 packages (ground-codes / geoint / codebook / ui / eslint-config / typescript-config).
- husky pre-commit + lint-staged 활성, local commit 시 lint 자동 실행.
- 2025-03-28 이후 13개월간 첫 배포 시점에 Cloudflare Pages 정책 강화로 favicon edge runtime 누락 발견됨, fix PR #3 으로 favicon 을 app/ 에서 public/ 으로 이동.

## 최근 액션 로그
- 2026-05-09 · favicon edge runtime 미설정으로 Cloudflare Pages 배포 실패, apps/web/app/favicon.ico 를 apps/web/public/favicon.ico 로 이동하는 fix PR 생성 · https://github.com/hmmhmmhm/ground.codes/pull/3 (분리 작업과 무관한 사전 인프라 이슈)
- 2026-05-05 14:43 · place-details.tsx 871줄에서 8개 파일 폴더 구조(index.tsx 358 + helpers + photo-gallery + photo-modal + types + use-copy + use-ground-code + use-place-details) 로 분리 · https://github.com/hmmhmmhm/ground.codes/pull/2 (머지 완료, 머지 후 favicon 배포 이슈 발견)
- 2026-05-05 13:40 · AGENTS.md + CLAUDE.md 신규 추가 · https://github.com/hmmhmmhm/ground.codes/pull/1 (머지 완료)
```

## star-carrier

로컬 경로: `~/Documents/personal-agent/projects/star-carrier/PROJECT.md`

```markdown
# star-carrier

## Mission
Phase 0 컨셉 단계의 private 사이드 프로젝트입니다. 현재 자율 작업의 1차 보호 가치는 컨셉 문서 정합성 점검과 레퍼런스 큐레이션입니다.

## Workspace
- Local checkout: `/Users/hm/Documents/personal-agent/workspaces/star-carrier`
- Remote: `https://github.com/hmmhmmhm/star-carrier`

## 자율 작업 정의

### 1. 컨셉 문서 정합성 점검
Phase 0 문서의 목표, 용어, 레퍼런스가 서로 충돌하지 않는지 점검합니다. 코드 스캐폴드 진입 전에는 구현 PR 을 만들지 않습니다.

### 2. 레퍼런스 큐레이션
컨셉 검증에 필요한 참고 자료를 수집하고, 사용자가 다음 결정을 5분 안에 내릴 수 있게 요약합니다.

### 3. 코드 스캐폴드 진입 후 자율 작업 확장
레포 구조와 첫 코드가 생긴 뒤에만 의존성, 테스트, 450줄 룰 등 일반 자율 작업을 확장합니다.

## 사람 승인 게이트
- 신규 레포 생성, 코드 스캐폴드, 구현 방향 결정은 사람만 합니다.
- 자율 작업은 문서 정합성 점검과 레퍼런스 정리에 한정합니다.

## Facts
- 2026-05-10 Notion SoT 의 Tier A 목록에 `star-carrier` 가 새로 추가되었습니다.
- Notion SoT 에 아직 별도 PROJECT.md 번들은 없어서, 본 파일은 카탈로그 항목을 기준으로 만든 초기 로컬 메모입니다.
- 2026-05-11 유닛 실루엣 pass 17 을 기준으로 디자인 탐색을 잠정 완료했습니다.
- 2026-05-11 React + Vite + Canvas 2D 스모크 테스트 스캐폴드를 시작했습니다.
- 2026-05-11 렌더러를 카메라, 엔티티, 실루엣 데이터, hit test, draw 모듈로 분리했습니다.
- 2026-05-11 모바일 퍼스트 UI 기준과 `npm run verify:agent` 에이전트 검증 루틴을 추가했습니다.
- 2026-05-11 선택 유닛 이동 명령과 `update(dt)` 게임 루프를 추가했습니다.
- 2026-05-11 캔버스 풀스크린 전환, 곡선 이동, 파이터 선택 표시, 핀치 줌을 추가했습니다.
- 2026-05-11 초기 플레이어 유닛을 아군/적 L캐리어 1대씩으로 정리하고 터렛 표시를 개선했습니다.
- 2026-05-11 L캐리어 선택 시 표시되는 생산 UI와 생산/설치 기본 규칙을 추가했습니다.
- 2026-05-11 생산 UI를 단일 PRODUCE 버튼에서 전체 목록으로 진입하는 흐름으로 조정했습니다.
- 2026-05-11 아군 전용 선택, MOVE 명령 버튼, lucide 액션 아이콘을 추가했습니다.
- 2026-05-11 MOVE를 SET PATH로 바꾸고 다중 waypoint 연속 이동을 추가했습니다.
- 2026-05-11 경로가 있는 유닛에만 표시되는 CLEAR PATH 액션을 추가했습니다.
- 2026-05-11 캐리어/터렛 공격 범위, 자동 미사일, 체력바 전투 표시를 추가했습니다.
- 2026-05-11 유닛/미사일 이동 속도를 낮추고 캐리어 크기별 미사일 salvo를 추가했습니다.
- 2026-05-11 파워 서플라이 에너지 생산, 보유 에너지 HUD, 에너지 부족 생산 비활성화를 추가했습니다.

## 최근 액션 로그
- 2026-05-10 18:30 · Notion SoT 의 신규 Tier A 항목을 로컬 PROJECT.md 초기 메모로 반영 · no-op
- 2026-05-11 23:30 · `docs/refs/unit-silhouettes.svg` 로 유닛 실루엣 기준을 고정하고 컨셉 문서에 반영 · docs
- 2026-05-11 23:50 · React + Vite 앱과 Canvas 2D 유닛 렌더링 smoke test 를 추가 · scaffold
- 2026-05-11 23:59 · 카메라 좌표계, 유닛 엔티티 모델, hover/select 상호작용, 순수 함수 테스트를 추가 · code
- 2026-05-11 24:05 · 모바일 viewport 레이아웃과 agent-browser 기반 전체 검증 스크립트를 추가 · test
- 2026-05-11 24:15 · 선택 유닛 이동 명령, 목표점 표시, 모바일 자동 플레이 smoke test 를 추가 · code
- 2026-05-11 03:30 · 전체 화면 캔버스, 제한 각속도 기반 곡선 이동, 핀치 줌 검증을 추가 · code
- 2026-05-11 06:05 · 초기 아군/적 유닛을 L캐리어 1대씩으로 제한하고 터렛 정방향/테두리를 보정 · code
- 2026-05-11 06:10 · L캐리어 생산 카드 UI, 이동 유닛 생성, 현위치 구조물 설치/중복 방지 검증을 추가 · code
- 2026-05-11 06:18 · 생산 UI에 PRODUCE/BACK 흐름을 추가하고 카드 아이콘 stroke 크기를 보정 · code
- 2026-05-11 06:25 · 적 유닛 조종 차단, MOVE 버튼 기반 이동, PRODUCE lucide 아이콘을 추가 · code
- 2026-05-11 06:32 · SET PATH 액션, waypoint 누적, 순차 경로 이동 렌더링/검증을 추가 · code
- 2026-05-11 06:38 · 경로 삭제 버튼과 queued waypoint 제거 검증을 추가 · code
- 2026-05-11 07:10 · 캐리어/터렛 사거리 기반 자동 미사일 발사, 피해, 체력바 렌더링을 추가 · code
- 2026-05-11 07:40 · 느린 유닛/미사일 속도, S/M/L 캐리어 1/2/3발 salvo, 피해 시 체력바 표시를 반영 · code
- 2026-05-11 07:55 · 구조물 측면 설치/근접 차단, 파워 서플라이 초당 에너지 수입, 비용 부족 UI 비활성화를 추가 · code
```