겪은 것만 씁니다.

쓰는 사람

rian — 프론트엔드 개발자 3년차. 웹 프론트엔드를 주로 다루고, 개발환경은 WSL2 위의 Linux 와 Windows 를 오가며 씁니다. 저장소 하나에서 여러 브랜치를 동시에 굴리는 git worktree 기반 작업, AI 코딩 도구를 실제 작업에 붙여 쓰는 구성에 관심이 많습니다.

막혔던 문제와 그때 통한 해결책을 개인 메모로 계속 쌓아 왔습니다. 그중 남에게도 쓸모가 있겠다 싶은 것을 공개용으로 다시 써서 여기에 올립니다. 코드와 이력은 GitHub 프로필에서 볼 수 있습니다.

어떻게 쓰는가

모든 글은 직접 겪은 문제에서 출발합니다. 문서를 읽고 정리한 요약이나 남의 해결책을 옮겨 적은 글은 올리지 않습니다. 그래서 다음 세 가지가 항상 본문에 들어갑니다.

• 에러 메시지 원문 — 편집하지 않은 그대로. 같은 문제를 검색으로 만난 사람이 자기 상황과 대조할 수 있어야 하기 때문입니다.
• 재현 명령어와 환경 — 어떤 버전, 어떤 플랫폼에서 일어났는지. 환경이 다르면 해결책도 달라집니다.
• 실제로 적용한 해결책 — "이렇게 하면 될 것 같다"가 아니라 적용해서 문제가 사라진 것만 씁니다. 통하지 않았던 시도도 함께 적습니다. 같은 길로 헛걸음하지 않도록.

반대로 검증하지 못한 추측은 추측이라고 밝히고, 확인하지 않은 버전·수치는 적지 않습니다. 나중에 내용이 틀렸다는 걸 알게 되면 글을 지우지 않고 고친 뒤 수정일을 남깁니다.

다루는 주제

• WSL·Windows 개발환경 — WSL2 와 Windows 를 오가며 개발할 때 터지는 것들. 클립보드, 알림, 크론, 키보드 리매핑. (7편)
• 프론트엔드 함정 — CSS·번들러·타입스크립트·브라우저가 문서대로 동작하지 않을 때. 원인이 비자명했던 것만. (9편)
• Git worktree·멀티세션 — 한 저장소에서 여러 브랜치를 동시에 굴릴 때 생기는 문제들. worktree 운영 규칙과 사고 사례. (6편)
• AI 코딩 도구 — Claude Code·Codex·MCP 를 실제 작업에 붙여 쓰면서 부딪힌 설정과 제약. (3편)
• 검증과 파일 포맷 — 결과를 어떻게 확인했는지가 본문의 핵심인 기록. 브라우저 컨텍스트 격리, 바이너리 문서 diff. (2편)

연락

내용이 틀렸거나, 다른 환경에서 다르게 동작하거나, 더 나은 방법을 알고 있다면 알려주세요. 확인해서 본문에 반영합니다. 문의 페이지의 양식을 쓰거나 contact@rianhq.com로 메일을 보내면 됩니다.

이 사이트에 대해

Astro 로 만든 정적 사이트이고 Cloudflare 에서 호스팅합니다. 방문자 추적용 분석 도구는 쓰지 않습니다. 광고와 쿠키에 대한 내용은 개인정보처리방침에 적어 두었습니다.