imprun engineering

작성일: 2025년 12월 29일카테고리: Claude Code, Developer Tools, Performance키워드: Claude Code, 토큰 최적화, MCP, 플러그인, 컨텍스트 관리요약Claude Code에서 /compact 실행 후에도 컨텍스트가 33% 사용 중이었다. /context 명령어로 분석한 결과, 불필요한 MCP 도구(22.6k 토큰)와 중복 플러그인이 원인이었다. 정리 후 10%로 줄였고, Plan 모드와 Phase 분리 패턴으로 효율적인 작업 방식을 정립했다.문제 상황왜 컨텍스트 관리가 중요한가Claude Code의 컨텍스트는 책상 위 공간과 같다. 책상이 좁으면 필요한 자료를 펼칠 수 없다. 컨텍스트가 부족하면 Claude가 코드를 분석하고 수정하는 데 필요한 정보를 담을..

작성일: 2025년 12월 28일 (Windows 패치 추가: 12월 29일)카테고리: Claude Code, Developer Tools, AI Coding키워드: Claude Code, LSP, Language Server Protocol, Serena, MCP, AI Coding, Windows요약Claude Code v2.0.74부터 LSP(Language Server Protocol)가 네이티브로 지원된다. 이전에는 Serena MCP 같은 외부 도구를 설치해야 했던 시맨틱 코드 분석 기능이 이제 플러그인 설정만으로 사용 가능하다. 이 글에서는 Serena MCP에서 Claude Code 네이티브 LSP로 전환하는 방법과 실제 사용 경험을 공유한다.문제 상황: 왜 LSP가 필요했나grep/glo..

작성일: 2025년 12월 28일카테고리: Git, AI Development, Workflow키워드: git worktree, Claude Code, multi-agent, 동시 개발, 브랜치 관리요약Claude Code를 여러 개 동시에 실행하면 개발 속도를 높일 수 있다. 하지만 같은 프로젝트 폴더에서 여러 에이전트가 작업하면 빌드 충돌과 파일 충돌이 발생한다.git worktree를 사용하면 이 문제를 해결할 수 있다. 하나의 저장소에서 여러 작업 디렉토리를 만들어 각 Claude Code 인스턴스가 독립적으로 작업하도록 구성한다. 이 글에서는 Claude Code로 worktree를 생성하고 멀티 에이전트 환경을 구축하는 방법을 소개한다.문제: 같은 폴더에서 멀티에이전트 충돌여러 에이전트를 동시..

작성일: 2025년 12월 25일카테고리: AI, Developer Tools, Claude Code키워드: CLAUDE.md, AGENTS.md, symlink, @import, Claude Code요약Claude Code의 공식 문서에서 @import 문법으로 AGENTS.md를 참조하라고 안내하고 있지만, 실제 개발 환경에서 Claude가 AGENTS.md를 읽지 않는 경우가 빈번하게 발생합니다. 이 글에서는 해당 문제의 원인을 분석하고, 심볼릭 링크를 활용한 현실적인 해결책을 공유합니다.문제 상황공식 가이드의 @import 문법Claude 공식 블로그와 Memory Documentation에서는 @path/to/file 문법으로 다른 마크다운 파일을 import할 수 있다고 안내합니다.# CLAU..

작성일: 2025년 12월 22일카테고리: Tools, AI, Warning키워드: Google Antigravity, Claude Code, Git, 작업 손실, AI 코딩 도구요약Google Antigravity와 Claude Code를 같은 작업 폴더에서 동시에 사용하던 중, Antigravity 업데이트 시 git checkout이 실행되어 Claude Code로 수정한 파일이 전부 초기화되는 사고가 발생했다. AI 코딩 도구를 동시에 사용할 때는 반드시 작업 폴더를 분리하거나, 수시로 커밋하는 습관이 필요하다.사고 경위상황동일한 Git 저장소 폴더를 VS Code에서 열고 작업Claude Code로 프론트엔드 에픽을 멀티 에이전트로 진행 중약 40개 파일이 수정된 상태로 누적동시에 Google ..

작성일: 2025년 12월 22일카테고리: Web, HTTP, Security키워드: HTTP Cookie, Session, Security, SameSite, HttpOnly, Secure요약HTTP는 본질적으로 무상태(Stateless) 프로토콜이다. Cookie는 이 무상태 프로토콜에서 상태를 유지하기 위해 1994년 Netscape에서 도입한 메커니즘이다. 이 글에서는 Cookie의 내부 동작 원리부터 보안 속성, 실무에서 마주치는 문제들과 해결 방안까지 깊이 있게 다룬다.Cookie의 탄생 배경HTTP의 무상태 특성HTTP 프로토콜은 각 요청이 독립적이다. 서버는 이전 요청에 대한 정보를 기억하지 않는다.GET /page1 HTTP/1.1Host: example.com(서버는 이 요청을 처리하고..

작성일: 2025년 12월 22일카테고리: Frontend, Next.js, Tailwind CSS키워드: Next.js, Tailwind CSS v4, shadcn/ui, next-themes, Dark Mode, CSS Variables요약shadcn/ui의 zinc 테마를 next-themes로 확장할 때 테마 전환이 동작하지 않는 문제가 발생한다. 근본 원인은 text-zinc-400 같은 하드코딩된 Tailwind 색상 클래스가 CSS 변수를 참조하지 않기 때문이다. 이 글에서는 올바른 테마 시스템 설정 방법과 자주 하는 실수, 그리고 색상 사용 가이드를 정리한다.문제 상황: 왜 테마가 깨지는가?전형적인 시나리오shadcn/ui로 Next.js 프로젝트 초기화 (zinc 테마 선택)next-th..

작성일: 2025년 12월 22일카테고리: Backend, Go, Troubleshooting키워드: Go, GORM, PostgreSQL, Troubleshooting, TimeZone요약GORM을 사용하면서 실제 프로덕션 환경에서 마주친 Edge Cases와 해결 방법을 정리한다. 타임존(KST/UTC) 불일치 문제, Zero Value 업데이트 함정, AutoMigrate와 init.sql의 권한 충돌, 그리고 Upsert, Hook 전파, 연결 끊김 등 실무에서 시간을 허비하기 쉬운 함정들을 다룬다.1. 타임존(TimeZone) 불일치 문제KST(Asia/Seoul) 환경에서 운영할 때 가장 흔하게 겪는 문제다.문제 상황// 한국 시간 2025-12-22 15:00:00에 레코드 생성user :=..

작성일: 2025년 12월 22일카테고리: Backend, Go, Architecture키워드: Go, GORM, Clean Architecture, Repository Pattern, PostgreSQL요약엔터프라이즈급 Go API Server를 구축할 때 GORM을 어떻게 활용해야 하는지 실제 프로젝트 사례를 통해 설명한다. Clean Architecture 기반의 계층 분리, Repository 패턴 구현, Custom Type을 활용한 JSONB 처리, 그리고 멀티테넌시와 감사 로그 설계까지 프로덕션 환경에서 검증된 패턴을 다룬다.프로젝트 구조Clean Architecture를 적용한 Go API Server의 표준 구조다.api/├── cmd/server/ # 애플리케이션..

작성일: 2025년 12월 22일카테고리: Backend, Go키워드: Go, GORM, ORM, PostgreSQL, Database요약GORM은 Go 생태계에서 가장 널리 사용되는 ORM(Object-Relational Mapping) 라이브러리다. 이 글에서는 GORM의 핵심 개념, 주요 기능, 그리고 실제 프로젝트에서의 활용 방법을 다룬다. 데이터베이스 연결부터 모델 정의, CRUD 작업, 관계 설정까지 실무에서 필요한 내용을 단계별로 설명한다.GORM이란GORM(Go Object Relational Mapper)은 Go 언어를 위한 풀 피처 ORM 라이브러리다. 개발자가 SQL을 직접 작성하지 않고도 Go 구조체를 통해 데이터베이스를 조작할 수 있게 해준다.주요 특징Auto Migration: ..