AI가 일하기 좋은 레포 만들기
3줄 요약 AI 에이전트는 그럴듯하게 틀려요. 테스트가 통과해도, 설명이 논리적이어도요. 그래서 사고가 날 때마다 그날 규칙을 남겼어요. 규칙은 문서보다 자동 검사로 지킬 때 오래가요. 무엇을 했나 보장플러스는 보험 보장분석 웹 서비스예요. 자바로 만

콘캣이 쌓아온 경험과 이야기를 한곳에 모았습니다.
11건 · 최신순
3줄 요약 AI 에이전트는 그럴듯하게 틀려요. 테스트가 통과해도, 설명이 논리적이어도요. 그래서 사고가 날 때마다 그날 규칙을 남겼어요. 규칙은 문서보다 자동 검사로 지킬 때 오래가요. 무엇을 했나 보장플러스는 보험 보장분석 웹 서비스예요. 자바로 만

기사 재구성 구조를 한 번에 쓰기 → 문단 단위 → 문단 묶음 → 블라인드 2콜로 세 번 바꾸며, 콜 수가 65% 줄어도 비용은 20%만 준 이유와 모델 교체 뒤 돌아온 베끼기를 측정으로 따라간 기록.

같은 기사의 조회수가 화면마다 100·3·7로 달랐고, 새로고침해도 오르지 않았고, 리포트에서는 0회 기사가 사라졌다. 셋 다 카운터 고장이 아니라 정의의 문제였던 기록.

LLM 뉴스 파이프라인에서 "원문을 베끼지 마"라는 프롬프트 금지 규칙이 왜 0을 보장하지 못했는지, 그래서 타입·모듈 경계·테스트로 원문이 닿는 경로 자체를 없앤 기록.

"다들 하는데 나만 뒤처진다"는 불안에서 목적 없이 바이브 코딩을 시작한 프로덕트 디자이너의 기록. 회사의 디자이너-개발자 1:1 프로젝트에서 코드베이스를 얻고 나서야 방향을 찾은 과정과, Claude와 Claude Code의 권한 차이, 코드베이스 작업에 처음 발을 들이는 실전 팁을 담았다.

피그마 MCP와 클로드로 모바일 디자인 시스템을 데스크탑 대시보드로 옮긴 '바이브 코딩' 프로젝트에서, 주니어 디자이너가 AI를 향한 세 가지 편견이 깨진 기록. 모호한 형용사 대신 구조화된 명령이 필요했고, 전문가 페르소나를 줘도 AI는 멘토가 아니라 비위를 맞추는 작업자였으며, 가이드의 빈틈은 곧 내 시스템의 구멍이었다는 깨달음을 정리했다.

VS Code + Claude + Figma로 디자인 시스템부터 화면 퍼블리싱까지 AI로 진행해 디자인 기간을 2주 앞당긴 기록. md 파일을 기준점으로 시스템을 관리하고 코드를 다시 Figma로 되돌리는 워크플로, 그리고 코드 기반 협업에서 부딪힌 병합·히스토리 관리의 어려움을 정리했다.

입사 3개월 신입 디자이너가 Figma 대신 Claude Code와 마크다운으로 디자인을 시작하게 된 기록. 세일즈맵의 마커·경로 바 작업을 예로, 추상적 시각 언어보다 수치로 지시해야 하는 이유와 코드↔Figma 왕복 워크플로, 그리고 시각화·마감 도구로 위치가 바뀐 Figma를 이야기한다.

정해진 디자인 시스템 컴포넌트로만 화면을 생성하는 서비스를 만들며, 프롬프트를 '컴파일러'처럼 설계한 이야기. 모델이 코드 대신 엉뚱한 영문 기사를 뱉은 recitation 이탈을 추적하고, "이탈은 못 막아도 새어 나가는 건 막는다"는 출력 검증·관측 안전망으로 대응한 기록.

Figma MCP의 read/write 비대칭과 fontName의 함정. 코드→Figma write에서 Pretendard가 Inter로 폴백된 원인을 파헤치고, use_figma의 폰트 카탈로그 검증을 우회해 generate_figma_design import 경로로 폰트를 지켜낸 기록.
