1인 개발자가 실제로 겪은 개발환경·워크플로 트러블슈팅 기록. 에러 원문과 재현 명령어, 실제로 통한 해결책까지.https://rianhq.comkohttps://rianhq.com/articles/git-local-origin-head-stale-after-default-branch-changehttps://rianhq.com/articles/git-local-origin-head-stale-after-default-branch-change로컬 clone 의 refs/remotes/origin/HEAD 는 clone 시점에 한 번만 설정되고 이후 자동 갱신되지 않는다. origin/HEAD 를 보고 분기하는 도구는 전부 옛 기본 브랜치를 쓴다.Wed, 15 Jul 2026 00:00:00 GMThttps://rianhq.com/articles/google-fonts-gugi-webkit-text-stroke-artifacthttps://rianhq.com/articles/google-fonts-gugi-webkit-text-stroke-artifactGoogle Fonts Gugi 로 바꾸자 글자 사이에 작은 점이 렌더링됐다. stroke 를 빼면 사라진다. 글리프의 분리된 서브패스에 외곽선이 독립적으로 그려지기 때문으로 보인다.Wed, 15 Jul 2026 00:00:00 GMThttps://rianhq.com/articles/github-closes-keyword-requires-default-branchhttps://rianhq.com/articles/github-closes-keyword-requires-default-branchGitHub 의 closing keyword 는 PR 의 base 가 저장소 기본 브랜치일 때만 동작한다. develop 기반 워크플로로 옮기는 중이면 조용히 무시된다.Tue, 14 Jul 2026 00:00:00 GMThttps://rianhq.com/articles/playwright-newpage-separate-context-no-shared-storagehttps://rianhq.com/articles/playwright-newpage-separate-context-no-shared-storagebrowser.newPage() 는 호출할 때마다 새 BrowserContext 를 만든다. 같은 오리진이어도 localStorage 와 BroadcastChannel 이 전혀 공유되지 않는다.Tue, 14 Jul 2026 00:00:00 GMThttps://rianhq.com/articles/mining-old-session-transcripts-for-lost-researchhttps://rianhq.com/articles/mining-old-session-transcripts-for-lost-research서브에이전트에게 시킨 대량 조사에서 최종 요약만 기록하고 원본은 버린 줄 알았는데, 세션 JSONL 은 삭제되지 않고 영구 보존된다. 위치와 파싱 방법.Sun, 12 Jul 2026 00:00:00 GMThttps://rianhq.com/articles/flex-item-fixed-width-iframe-minwidth-overflowhttps://rianhq.com/articles/flex-item-fixed-width-iframe-minwidth-overflowtransform 은 레이아웃에 영향을 주지 않는다. 고정폭 iframe 의 원래 폭이 flex item 의 min-content 크기로 잡혀 flex-basis 를 무시하고 컬럼을 아래로 떨어뜨린다.Sat, 11 Jul 2026 00:00:00 GMThttps://rianhq.com/articles/css-negative-zindex-body-background-hiddenhttps://rianhq.com/articles/css-negative-zindex-body-background-hiddenposition:fixed + z-index:-1 로 깐 배경이 Chromium 에서 body 배경색에 덮인다. getComputedStyle 로는 전부 정상으로 보여서 스크린샷 없이는 못 잡는다.Fri, 10 Jul 2026 00:00:00 GMThttps://rianhq.com/articles/pptx-spec-version-diffhttps://rianhq.com/articles/pptx-spec-version-diff슬라이드 100장짜리 설계서가 v5.2 에서 v5.3 으로 올라왔다. 눈으로 대조하는 대신 슬라이드 단위로 텍스트를 뽑아 diff 를 뜨고, 도형 좌표로 항목 순서를 판정한다.Fri, 10 Jul 2026 00:00:00 GMThttps://rianhq.com/articles/claude-code-automode-self-merge-pr-blockhttps://rianhq.com/articles/claude-code-automode-self-merge-pr-block에이전트가 자기가 만든 PR 을 병합하려 하면 차단된다. 차단을 풀려고 설정을 고치는 것도, 그 설정 파일을 읽는 것도 막힌다. 버그가 아니라 의도된 경계다.Wed, 08 Jul 2026 00:00:00 GMThttps://rianhq.com/articles/git-worktree-vanishes-under-running-devserverhttps://rianhq.com/articles/git-worktree-vanishes-under-running-devserver실행 중이던 vite 프로세스의 cwd 가 (deleted) 로 바뀌고 worktree list 에서 항목 자체가 소멸했다. 원인은 특정하지 못했고, 복구도 불가능했다. 운용 원칙으로 대응한다.Wed, 08 Jul 2026 00:00:00 GMThttps://rianhq.com/articles/vite-ssrloadmodule-node-integration-test-firestore-tombstonehttps://rianhq.com/articles/vite-ssrloadmodule-node-integration-test-firestore-tombstoneimport.meta.env 를 참조하는 앱 소스는 plain node 로 import 하면 터진다. Vite dev 서버의 ssrLoadModule 로 실제 소스를 Node 에서 그대로 실행하면 브라우저 없이 함수 단위 검증이 된다.Mon, 06 Jul 2026 00:00:00 GMThttps://rianhq.com/articles/tsc-resolvejsonmodule-oom-large-jsonhttps://rianhq.com/articles/tsc-resolvejsonmodule-oom-large-jsonresolveJsonModule 은 JSON 값에서 리터럴 타입을 통째로 추론한다. 런타임과 번들링은 멀쩡한데 타입체크만 죽고, 힙을 키워도 해결되지 않는다.Sun, 05 Jul 2026 00:00:00 GMThttps://rianhq.com/articles/nextog-icon-without-font-satorihttps://rianhq.com/articles/nextog-icon-without-font-satoriSatori 는 시스템 폰트 폴백이 없어 넘긴 fonts 에 없는 글자를 두부로 그린다. 아이콘이 글자가 아니라 도형이면 폰트가 아예 필요 없다.Thu, 02 Jul 2026 00:00:00 GMThttps://rianhq.com/articles/orval-fetch-client-no-throw-mutatorhttps://rianhq.com/articles/orval-fetch-client-no-throw-mutatorhttpClient fetch 로 생성한 코드는 res.ok 를 확인하지 않고 status 무관하게 resolve 한다. react-query 는 throw 해야 에러로 인식하므로 4xx/5xx 가 전부 isSuccess 가 된다.Tue, 30 Jun 2026 00:00:00 GMThttps://rianhq.com/articles/claude-mcp-add-default-scopehttps://rianhq.com/articles/claude-mcp-add-default-scopeMCP 서버를 등록해도 다른 디렉터리에서 연 세션에서는 안 보인다. 기본 scope 가 local 이라 실행한 cwd 아래에만 저장되기 때문이다.Sun, 28 Jun 2026 00:00:00 GMThttps://rianhq.com/articles/git-worktree-share-gitignored-envhttps://rianhq.com/articles/git-worktree-share-gitignored-envgit worktree add 는 tracked 파일만 체크아웃하므로 gitignore 된 .env 는 절대 따라오지 않는다. 래퍼 함수 대신 post-checkout 훅을 쓰면 어떤 방식으로 만들든 자동으로 연결된다.Thu, 25 Jun 2026 00:00:00 GMThttps://rianhq.com/articles/react-library-free-column-drag-reorderhttps://rianhq.com/articles/react-library-free-column-drag-reorderdnd-kit 없이 Pointer Events 만으로 칼럼 순서 변경을 구현했다. 칼럼이 단일 DOM 이 아닌 row-major 그리드에서, 리렌더 없이 60fps 를 유지하는 방법.Mon, 22 Jun 2026 00:00:00 GMThttps://rianhq.com/articles/typescript-eslint-worktree-dual-tsconfigrootdirhttps://rianhq.com/articles/typescript-eslint-worktree-dual-tsconfigrootdirrepo 내부에 git worktree 를 두면 tsconfig.json 이 두 벌 존재해 typescript-eslint 의 tsconfigRootDir 자동탐지가 후보를 결정하지 못한다. 208개 파일이 전부 파싱에러.Fri, 19 Jun 2026 00:00:00 GMThttps://rianhq.com/articles/worktree-dev-server-strategyhttps://rianhq.com/articles/worktree-dev-server-strategypm2 는 프로세스 이름이 전역이라 같은 프로젝트의 worktree 를 동시에 띄울 수 없고, 시작 시점 PATH 를 박아둬서 fnm 과 충돌한다. 경로 해시 기반 결정적 포트 스크립트로 교체했다.Fri, 19 Jun 2026 00:00:00 GMThttps://rianhq.com/articles/wsl-cron-git-push-gcm-gh-credentialhttps://rianhq.com/articles/wsl-cron-git-push-gcm-gh-credential터미널에서는 되는 git push 가 cron 에서만 실패한다. 전역 credential helper 가 Windows GCM 이라 인증창을 띄울 수 없어서다. repo 단위로 gh 토큰 helper 를 붙여 해결한다.Thu, 18 Jun 2026 00:00:00 GMThttps://rianhq.com/articles/trafficmonitor-ai-usage-wsl-codex-claudehttps://rianhq.com/articles/trafficmonitor-ai-usage-wsl-codex-claudeCodex 값은 세션 jsonl 경로가 WSL 안에만 있어서, Claude 값은 헬퍼가 PowerShell 5.1 에서 DPAPI 복호화에 실패해서 멈춘다. 원인이 완전히 독립적이라 따로 고쳐야 한다.Fri, 12 Jun 2026 00:00:00 GMThttps://rianhq.com/articles/ai-frontend-design-refactor-strategyhttps://rianhq.com/articles/ai-frontend-design-refactor-strategy카드 남발·과한 라운드·보라 그라데이션은 우연이 아니다. 원인 패턴을 정리하고 ground-up 과 redesign 두 상황에서 각각 다른 워크플로를 쓴 기록.Wed, 10 Jun 2026 00:00:00 GMThttps://rianhq.com/articles/windows-capslock-app-switch-kanata-ahkhttps://rianhq.com/articles/windows-capslock-app-switch-kanata-ahkAutoHotkey 단독으로 CapsLock 을 modifier 로 쓰면 토글이 새거나 오발이 난다. Kanata 로 드라이버 수준에서 조합키로 바꾸고 AHK 는 앱 전환만 맡기면 안정된다.Fri, 05 Jun 2026 00:00:00 GMThttps://rianhq.com/articles/wsl2-windows-toast-notificationhttps://rianhq.com/articles/wsl2-windows-toast-notificationBurntToast 나 wsl-notify-send 설치 없이 Windows 내장 WinRT API 를 powershell.exe 로 직접 호출해 데스크톱 알림을 띄운다. 한글 깨짐은 UTF-16LE base64 인코딩으로 잡는다.Fri, 29 May 2026 00:00:00 GMThttps://rianhq.com/articles/tmux-wsl-osc52-clipboardhttps://rianhq.com/articles/tmux-wsl-osc52-clipboardtmux 밖에서는 되는 OSC 52 클립보드 복사가 tmux 안에서만 무음 실패한다. tmux 3.4+ 기본값 set-clipboard external 이 안쪽 앱의 OSC 52 를 호스트 터미널로 전파하지 않기 때문이다.Wed, 20 May 2026 00:00:00 GMThttps://rianhq.com/articles/wsl-obsidian-setuphttps://rianhq.com/articles/wsl-obsidian-setupWindows Obsidian 으로 WSL 폴더를 열면 9P 오버헤드와 watcher 불안정을 겪는다. WSLg 로 Linux 빌드를 띄우면 해결되지만 AppImage 추출·바이너리 직접 실행·CJK 폰트 링크가 필요하다.Tue, 19 May 2026 00:00:00 GMThttps://rianhq.com/articles/wsl2-windows-clipboard-koreanhttps://rianhq.com/articles/wsl2-windows-clipboard-koreanWSL2 에서 clip.exe 로 한글을 복사하면 메모장에서 깨진다. 원인은 시스템 ANSI 코드페이지 해석. PowerShell Set-Clipboard 또는 UTF-16LE BOM 으로 해결한다.Tue, 19 May 2026 00:00:00 GMT