[ 안드로이드 AI 활용 ] 바이브 코딩(Vibe Coding) 및 Agent.md 활용 (36~37일차 기록)

1. 오늘 한 것

① AI 바이브 코딩(Vibe Coding) 패러다임 실습

• 다가올 3일간의 안드로이드 미니 프로젝트를 대비하여, 코드를 한 줄씩 직접 타이핑하는 방식에서 벗어나 AI(Claude, Codex 기반 툴 등)에게 개발 의도(Vibe)를 전달해 코드를 생성하고 조립하는 '바이브 코딩' 기법을 집중적으로 연습함.

② CLI 기반 AI 코딩 에이전트 활용

• GUI 에디터를 넘어 명령 프롬프트(CMD/Terminal) 환경에서 AI 에이전트와 상호작용하는 실습 진행.
• 터미널에서 직접 요구사항을 입력하여 프로젝트 스캐폴딩(초기 구조 세팅), 파일 생성, 기존 코드 리팩토링 및 버그 수정을 AI가 자동으로 수행하도록 지시.

③ 프로젝트 컨텍스트의 핵심: agent.md 작성 및 활용

• AI에게 "내가 어떤 환경에서, 어떤 규칙으로 개발하고 있는지"를 명확히 인지시키기 위한 가이드 문서(agent.md 또는 .cursorrules) 작성법 숙지.
• agent.md 구성 요소: * 프로젝트 목표 및 설명
  • 사용 기술 스택 (Java, Android SDK 버전 등)
  • 디렉토리 및 아키텍처 구조
  • 네이밍 컨벤션 및 반드시 지켜야 할 규칙 (예: UI 스레드 제어 원칙, XML 명명 규칙 등)

---

2. 문제 / 헷갈린 점

① "대충 말해도 찰떡같이 짜주겠지"의 함정

• 상황: AI에게 단순히 "안드로이드 로그인 화면 만들어줘"라고 지시했더니, 프로젝트 폴더 구조를 무시하거나 구버전의 Deprecated된 라이브러리를 끌어다 쓰는 스파게티 코드를 생성함.
• 해결: 바이브 코딩은 '대충 말하는 것'이 아니라 '구조적으로 완벽한 지시를 내리는 것'임을 깨달음. AI가 헛소리(Hallucination)를 하지 않도록 요구사항 명세서를 쓰듯 논리적으로 프롬프트를 작성해야 정상적인 결과물이 나옴.

② 컨텍스트 유실 문제와 agent.md의 장점

• 상황: AI와 대화가 길어질수록 이전에 지시했던 코딩 스타일(예: 변수명 규칙, 리스너 작성 방식 등)을 자꾸 까먹고 제멋대로 코드를 짬.
• 해결: 루트 디렉토리에 agent.md를 만들어 프로젝트의 절대 규칙을 문서화하고, AI가 코드를 생성하기 전 항상 이 문서를 참조하도록 강제함. 이후 코딩 컨벤션이 일관되게 유지되고 불필요한 코드 수정을 요청하는 일이 획기적으로 줄어듦.

---

3. 오늘 배운 핵심

- 단순 코더(Coder)가 아니라 설계자이자 리뷰어다:

• 단순한 보일러플레이트 코드나 기본 UI 배치는 AI에게 맡겨 개발 속도를 압도적으로 단축하고, 개발자는 전체 시스템 구조와 비즈니스 로직 설계, 그리고 AI가 짠 코드의 결함을 찾아내는(Review) 데 집중해야 한다.

- AI 코딩의 품질은 agent.md가 90%를 결정한다:

• AI에게 프로젝트의 컨텍스트를 얼마나 촘촘하게 먹여주느냐에 따라 산출물의 퀄리티가 하늘과 땅 차이로 벌어진다.

- 바이브 코딩은 소통이다:

• AI를 똑똑한 후배 개발자라고 생각하고, "왜 이렇게 짜야 하는지", "어떤 파일들을 참고해야 하는지" 구체적으로 가이드라인을 제시해야 한다.

---

4. 다음 목표

• 안드로이드 미니 프로젝트(3일) 돌입:
  • 주제 선정 및 화면 설계도(와이어프레임) 작성 완성.
  • 프로젝트 전용 agent.md 세팅
  • 배운 AI 툴(Claude, CLI 에이전트 등)을 적극 활용하여 핵심 기능 빠르게 프로토타이핑 하기.