2026-01-31

1일 1아티클

요즘IT

바이브 코딩 청소

문제 상황

• 기능 동작 X
• 원하던 방식을 AI가 이해하지 못함
• 문제의 핵심 → 코드량 증가 및 문맥 증가로 인한 AI의 요청사항 이해도 하락

코드 상 문제점

1. 하드코딩
   • AI가 사용자 요청을 단편적으로 수행하면서 발생하는 문제
   • ex. 가짜 데이터를 api → page 형태로 해야 api 부분을 실제 상황으로 수정하여 해결, but page 자체에 해당 값이 고정되어 있으면 수정 복잡도 증가
2. 컨벤션 룰 미준수
   • 배포 플랫폼과의 호환, 글로벌 상태를 쓰기 위한 Best Practice 미준수
   • 네이밍 컨벤션, DB 테이블 작성 규칙, API 연계 흐름, etc.
   • 기획 수정사항 또는 추가 발생 시, 변경 범위 최소화를 위한 규칙들의 미준수

해결 방법

1. 사용자가 에이전트 지시 사항에서 내용을 누락한 경우
   • 지시 사항 추가 후, 해당 지시 사항을 제대로 이행했는지 파일 검사를 AI에게 지시
2. 에이전트가 코드량 및 문맥 증가 등의 이유로 누락한 경우
   • 누락된 부분을 지시 사항 파일과 다시 매칭하는 방식으로 정리

바이브 코딩 플랫폼 엔지니어로서 하는 일들

1. 컨텍스트 지침서
   • 필요한 디렉토리에 규칙 정리용 .ai.md 파일 작성
   • AI가 반드시 해당 파일을 먼저 읽고 작업 시작하도록 지시
2. ESLint 커스텀
   • ESLint : 코드 작성 규칙 자동 검사 도구
   • 지침에 누락된 부분이 있을 수 있으므로, 컴파일러 결과물을 분석해 사용자가 원하는 형태로 코드를 작성했는지 확인하는 커스텀 룰 추가
   • 에이전트는 작업 수행 후, 코드 유효성 검사 스크립트 실행으로 규칙에 위반되는 코드 발견 → 수정 절차 진행
3. 제반 환경 연결
   • DB, 로그인, 이미지 업로등 등 서비스에 필요한 기반 세팅
   • 배포 비용 최소화
   • 서버리스 환경, Next.js 기반 인프라 구성
4. 바이브 코딩 툴 발전
   • 바이브 코더가 더 많은 프로젝트 수행 및 더 정확한 의도 반영을 하도록 툴 고도화
5. 리팩토링 스킬
   • 청소할 수록, 사용자가 놓쳤던 AI 지침 추가
   • 사용자가 반복적으로 요청했던 부분 (= AI가 자주 실수하는 항목) 자동화
   • 에이전트가 루프를 돌며 체크리스트 확인하는 리팩토링 스킬 제작

오늘 배운 것

1. PPT 디자인 템플릿화

내일 할 일

1. 기타 업무
2. PPT

참고자료

• 개발자가 바이브 코딩 청소하며 느낀 것들