imprun engineering

작성일: 2025년 11월 27일카테고리: AI, Backend, Architecture키워드: Claude Opus 4.5, Gemini 3.0, GPT-5.1, Go, Gin, gRPC, Clean Architecture요약프론트엔드 설계문서 비교에 이어, 동일한 프롬프트로 백엔드 설계문서 작성 능력을 비교했습니다. Go/Gin/GORM 기반의 Control Plane과 gRPC Agent 통신을 포함하는 복잡한 백엔드 아키텍처 설계를 테스트한 결과, Claude Opus 4.5가 프론트엔드와 마찬가지로 문서 구조, 코드 예시, 실무 적용 가능성에서 압도적 우위를 보였습니다.테스트 환경입력 자료architecture.md: Imp-Gateway v2 아키텍처 설계서 (논리/배포/물리 계층 분리, 엔티..

작성일: 2025년 11월 26일카테고리: AI, Frontend, Architecture키워드: Claude Opus 4.5, Gemini 3.0, GPT-5.1, Feature-Sliced Design, Next.js, AI 코딩요약Gemini 3.0, GPT-5.1 Codex Max, Claude Opus 4.5가 연이어 출시된 직후, 동일한 프롬프트로 프론트엔드 설계문서 작성 능력을 비교했습니다. 동료가 공유한 LinkedIn 글에서 "디자인 영역에서 Gemini 3.0이 압승"이라는 평가를 보고 Gemini Ultra를 결제하여 직접 테스트해봤습니다. 실무 개발자 관점에서 복잡한 B2B SaaS 프론트엔드 설계문서 작성 테스트를 진행한 결과, Claude Opus 4.5가 문서 구조, 기술적 깊..

작성일: 2025년 11월 25일카테고리: Developer Tools, AI, Productivity키워드: Claude Code, AI Coding, Workflow, Context Management, EPIC, Story, Daily Workflow요약imprun 팀에서 프로젝트 전체 기간 동안 매일 사용하는 Claude Code 실무 개발 워크플로우를 공유합니다. 새 기능 설계부터 구현, 일일 진행상황 추적, 주간보고까지 모든 과정을 자동화합니다. AI 질문으로 EPIC 문서 생성(/create-epic), EPIC을 Story로 분해(/start-epic), 매일 출근 시 Serena MCP로 코드 분석(/daily-start), 작업 중 /clear + /catchup으로 컨텍스트 복구, 퇴..

작성일: 2025년 11월 24일카테고리: Frontend Architecture키워드: Feature-Sliced Design, FSD, React, 프론트엔드 아키텍처, 모듈화, 레이어드 아키텍처요약Feature-Sliced Design(FSD)은 프론트엔드 프로젝트의 구조를 표준화하는 아키텍처 방법론입니다. 기술 중심이 아닌 비즈니스 기능 중심으로 코드를 조직하며, 7개의 레이어와 엄격한 의존성 규칙을 통해 확장 가능하고 유지보수하기 쉬운 코드베이스를 구축합니다. 현재 20,000개 이상의 오픈소스 프로젝트에서 채택되고 있습니다.FSD가 해결하는 문제전통적인 프론트엔드 구조의 한계대부분의 React 프로젝트는 다음과 같은 기술 중심 구조로 시작합니다:src/├── components/│ ├── ..

작성일: 2025년 11월 24일카테고리: AI, DevTools, Configuration키워드: Claude Code, Gemini CLI, OpenAI Codex, AGENTS.md, CLAUDE.md, AI Agent요약Claude Code, Gemini CLI, OpenAI Codex CLI 세 가지 AI 에이전트에서 AGENTS.md를 인식하도록 설정하는 방법을 정리합니다. 각 에이전트의 기본 파일명과 설정 방법이 다르지만, 적절한 설정을 통해 단일 AGENTS.md 파일로 모든 에이전트를 통합 관리할 수 있습니다.문제 상황배경모노레포 환경에서 여러 AI 코딩 어시스턴트를 사용할 때 다음 문제가 발생합니다:각 에이전트가 인식하는 기본 파일명이 다름 (CLAUDE.md, GEMINI.md, AG..

AI Agent를 위한 Frontend 개발 가이드: AGENTS.md로 Next.js + shadcn/ui 프로젝트 구조 설계작성일: 2025년 11월 24일카테고리: Frontend, AI, Architecture키워드: Next.js, React, AI Agent, AGENTS.md, CLAUDE.md, shadcn/ui, TanStack Query, Zustand요약AI 코딩 어시스턴트(Claude, Copilot 등)와 협업할 때 프로젝트 구조를 명확히 문서화하면 AI가 일관된 코드를 생성합니다. 이 글에서는 Next.js 16 + shadcn/ui 기반 프로젝트에서 AI Agent가 따라야 할 아키텍처 패턴, 네이밍 컨벤션, 데이터 흐름을 정의하는 방법을 공유합니다. 실제 B2B API Gat..

작성일: 2025년 11월 24일카테고리: AI, UX Design, API Gateway키워드: Claude, GPT Codex, Gemini, AI Review, UX, Menu Structure, API Gateway요약B2B API Gateway 플랫폼의 콘솔 메뉴 구조를 세 가지 AI 모델(Claude Sonnet 4.5, GPT 5.1 Codex Max, Gemini Pro 2.5)에게 리뷰 요청했습니다. 동일한 아키텍처 문서와 메뉴 스크린샷을 제공하고, 각 모델이 어떤 관점에서 피드백을 제시하는지 비교 분석했습니다. 세 모델 모두 긍정적인 평가를 내렸으나, 리뷰 스타일과 강조점에서 흥미로운 차이를 보였습니다.문제 상황배경imprun API Gateway Control Plane은 Provid..

작성일: 2025년 11월 23일카테고리: Kubernetes, Authentication키워드: Keycloak, Theme, ConfigMap, FreeMarker, Kubernetes요약Kubernetes 환경에서 Keycloak 커스텀 로그인 테마를 ConfigMap으로 배포하는 과정에서 여러 문제에 직면했습니다. ConfigMap이 중첩 디렉토리 구조를 보존하지 않는 특성과 네임스페이스 불일치 문제가 주요 원인이었습니다. 이 글에서는 Keycloak 테마의 구조, Kubernetes에서의 배포 방법, 그리고 배포 과정에서 겪은 시행착오와 해결 방법을 공유합니다.문제 상황증상프로덕션 환경에서 Keycloak의 기본 로그인 UI 대신 자체 브랜딩에 맞는 커스텀 테마가 필요했습니다. Kubernete..

Kubernetes Ephemeral Storage 문제 해결 가이드카테고리: Kubernetes, Troubleshooting, Storage, Technical Guide난이도: ⭐⭐⭐⭐⭐대상: Kubernetes 운영자, DevOps 엔지니어💡 이 문서는?기술 참조 문서: 단계별 해결 방법과 명령어실제 경험담: MongoDB가 죽었다: 150GB 디스크가 있는데 왜?예방 가이드: Oracle Cloud 준비 및 설정문제 상황증상MongoDB Pod가 Evicted 상태로 종료됨에러 메시지:The node was low on resource: ephemeral-storage.Threshold quantity: 4741241430, available: 4344280Ki.원인Oracle Cloud 무료..

작성일: 2025년 11월 18일카테고리: Kubernetes, Storage, Troubleshooting키워드: Kubernetes, Ephemeral Storage, Pod Eviction, Oracle Cloud, Block Volume요약Oracle Cloud 환경에서 Kubernetes를 운영하던 중 MongoDB Pod가 Evicted 상태로 종료되는 장애가 발생했습니다. 근본 원인은 150GB 블록 볼륨을 연결했으나 실제로 마운트하지 않아 Kubernetes가 root 파티션만을 ephemeral-storage로 인식한 것이었습니다. 이 글에서는 문제의 원인과 해결 과정, 그리고 재발 방지를 위한 방안을 공유합니다.문제 상황증상운영 중인 Kubernetes 클러스터에서 MongoDB Sta..