본문 바로가기
스터디 열기

Agent에게 프로젝트 요청하기

학습 목표

  • 무엇을 만들지와 조건을 담아 Agent에게 프로젝트를 맡길 수 있다
  • 진행 상황과 Implementation Plan을 확인할 수 있다
  • 계획을 보고 승인하거나 방향을 바꿀 수 있다

1. 프로젝트 요청하기

1.1 맥락을 담아 한 번에 맡기기

9장에서 본 것처럼 정교한 프롬프트 기법보다 중요한 것은 맥락입니다. 무엇을 만들고 싶은지, 꼭 지켜야 할 조건이 무엇인지를 한 번에 알려 주면 나머지는 Agent가 채우고, 애매한 부분은 계획 단계에서 되묻습니다.

Agent 패널(App은 메시지 상자, 맨 앞에 /plan)에 다음과 같이 입력합니다.

내가 매일 할 일을 적어 두고 끝낸 것을 지워 가는 Todo 웹 앱을 만들어주세요.
할 일을 추가하고, 체크박스로 완료 표시를 하고, 삭제할 수 있으면 됩니다.
새로고침해도 목록이 남도록 브라우저의 로컬 스토리지에 저장해 주세요.
나중에 정적 웹 호스팅에 그대로 올릴 거라 외부 라이브러리 없이 HTML, CSS, JavaScript로만 만들고,
index.html·style.css·script.js 세 파일로 나눠 주세요. 디자인은 깔끔하게, 휴대폰에서도 쓰기 편하게 해 주세요.
index.html의 title에는 앱 이름을 넣어 주세요.

목적(매일 쓰는 할 일 목록), 꼭 지킬 조건(외부 라이브러리 없음, 세 파일), 나중의 계획(인터넷에 올림)이 한 문단에 들어 있습니다. 화면 배치나 코드 구조는 적지 않았습니다. 그건 Agent가 정합니다. title에 앱 이름을 넣어 두면 10-04에서 볼 위니버시티 갤러리가 이 제목을 기본 제목으로 씁니다.

이전 Antigravity IDE에서 Todo 앱 제작을 맡긴 예시입니다. 모델·입력 안내는 촬영 당시 기준입니다.

1.2 요청 전송

메시지를 작성한 후 Enter 또는 전송 버튼을 클릭합니다.

2. 진행 상황 보기

계획부터 요청하면 Agent는 큰 일을 작은 단계로 나눈 작업 묶음(task group)으로 진행 상황을 보여 줍니다(6장). IDE에서는 Agent 패널에서, 여러 대화를 함께 볼 때는 IDE 안의 Agent Manager(Cmd/Ctrl + E)에서 봅니다. App에서는 대화 화면에 진행 상황이 나옵니다.

2.1 할 일 목록 예시

Agent가 나눈 할 일은 다음과 비슷할 수 있습니다.

## Todo 웹 애플리케이션 개발

- [ ] HTML 구조 작성 (index.html)
- [ ] CSS 스타일 작성 (style.css)
- [ ] JavaScript 기능 구현 (script.js)
  - [ ] Todo 추가 기능
  - [ ] Todo 완료 토글
  - [ ] Todo 삭제 기능
  - [ ] 로컬 스토리지 저장/불러오기

Agent가 나눈 할 일 목록과 진행 상황입니다.

3. Implementation Plan 검토

Agent가 코드를 작성하기 전에 Implementation Plan(구현 계획)을 보여줍니다. 코드를 한 줄씩 읽는 것이 아니라, 내가 원한 방향과 맞는지 판단하는 단계입니다.

3.1 계획에서 볼 것

항목판단할 내용
파일 목록내가 말한 세 파일로 나뉘었는가
기능빠진 기능이나 원하지 않은 기능이 있는가
조건외부 라이브러리 없이 만든다는 조건을 지켰는가

3.2 계획 예시

## 구현 계획

### 1. index.html
- 기본 HTML5 구조
- 입력 폼: 텍스트 입력 + 추가 버튼
- Todo 목록 컨테이너

### 2. style.css
- CSS 변수로 색상 관리
- Flexbox 레이아웃
- 반응형 디자인

### 3. script.js
- TodoApp 클래스로 구현
- localStorage API 사용
- 이벤트 위임 패턴 적용

Agent가 보여 준 Implementation Plan입니다.

4. 계획 승인 또는 수정

4.1 계획이 마음에 들면

Proceed 버튼을 클릭하여 Agent가 구현을 시작하도록 합니다.

4.2 방향을 바꾸고 싶으면

계획의 특정 부분을 골라 댓글을 달거나, 대화창에 바꾸고 싶은 점을 적습니다.

예시 1: 디자인 변경 요청

CSS에서 파란색 대신 초록색 계열을 사용해주세요.

예시 2: 기능 추가 요청

Todo 항목을 편집하는 기능도 추가해주세요.

예시 3: 구현 방식 변경

클래스 대신 함수형으로 구현해주세요.

피드백을 입력한 후 Agent가 계획을 수정할 때까지 기다립니다.

5. Agent가 코드 작성

계획을 승인하면 Agent가 코드를 작성합니다.

5.1 진행 상황 확인

  • 할 일 목록: 완료된 단계에 체크 표시
  • Agent 패널: 실시간 진행 상황

5.2 작성 완료 대기

Agent가 모든 파일을 작성할 때까지 기다립니다. 작업이 완료되면 아래와 같이 진행될 수 있습니다.

  • Walkthrough Artifact 생성
  • 변경된 파일 목록 표시
  • Review Changes에서 확인 가능

Walkthrough의 스크린샷

Walkthrough에 스크린샷이 포함되려면 Browser Subagent가 웹 페이지 작업을 수행해야 합니다. 코드 작성만 진행한 경우에는 스크린샷 없이 변경 요약만 표시됩니다. 다음 절에서 Agent에게 Browser 테스트까지 맡기면 스크린샷과 녹화가 함께 남습니다.

6. 생성된 파일 확인

6.1 Editor에서 확인

  1. Editor 뷰로 전환 (Cmd/Ctrl + E)
  2. 왼쪽 파일 탐색기에서 생성된 파일 확인:
    • index.html
    • style.css
    • script.js
  3. 궁금한 파일을 열어 봅니다

6.2 Review Changes로 확인

  1. Agent 패널 아래쪽 도구 막대의 Review Changes 클릭
  2. 변경된 파일 목록 확인
  3. 각 파일의 변경 내용 확인. 마음에 걸리는 줄에는 댓글을 달아 Agent에게 바로 전달할 수 있습니다

App에서는 대화 오른쪽 위 Overview 패널의 Review 줄을 누르면 같은 내용이 옆 패널에 열립니다. 바뀐 파일이 index.html, style.css, script.js 세 개뿐인지만 보면 됩니다. 이 밖의 파일(예: package.json)이 생겼다면 외부 라이브러리 없이 만들라는 조건을 어겼을 수 있으니 왜 만들었는지 묻습니다.

6.3 1분 동작 확인

테스트는 다음 절에서 Agent에게 맡기지만, 파일이 생기자마자 한 번 열어 보면 큰 문제는 바로 보입니다.

  1. 파일 탐색기에서 todo-app/index.html을 더블클릭해 브라우저로 엽니다.
  2. 입력칸에 우유 사기를 넣고 추가합니다. 목록에 우유 사기가 생기고 입력칸이 비워지면 됩니다.
  3. F5(Mac Cmd + R)로 새로고침합니다. 우유 사기가 그대로 있으면 로컬 스토리지 저장까지 된 것입니다.

정말 저장됐는지 눈으로 보고 싶다면 F12(Mac Cmd + Option + I)로 개발자 도구를 열고 Application 탭 > 왼쪽 Local Storage > 열린 페이지 주소를 누릅니다. 오른쪽 표에 todos 같은 이름(이름은 Agent가 정함)과 함께 [{"id":...,"text":"우유 사기","completed":false}]와 비슷한 값이 보입니다. 할 일을 체크하면 이 값의 completed가 true로 바뀝니다. 값의 모양도 Agent가 정하므로 글자가 조금 달라도 괜찮고, 내가 넣은 할 일이 들어 있는지만 보면 됩니다.

2번에서 아무 일도 일어나지 않으면 같은 개발자 도구의 Console 탭에 빨간 오류가 있는지 보고, 10-03의 4절처럼 증상과 오류를 Agent에게 그대로 알립니다.

"완료되었습니다"를 받았을 때

코드를 모두 이해할 필요는 없습니다. 대신 Agent에게 "어떤 방식으로 만들었는지 세 줄로 설명해 주세요"라고 물어보세요. 설명이 내가 원한 방향과 맞는지 판단하는 것이 사람의 몫입니다. 실제로 잘 동작하는지는 다음 절에서 Agent에게 테스트를 맡겨 확인합니다.

7. 문제 해결

7.1 Implementation Plan이 안 나와요

원인해결 방법
계획 없이 요청함요청 앞에 /plan을 붙여 다시 맡기기
계획 검토를 기다리지 않음App의 Plan Review Policy를 Always Ask로 변경(이전 IDE는 Artifact review policy의 Request review)

7.2 파일이 생성되지 않아요

  • Agent가 아직 작업 중인지 확인
  • 할 일 목록에서 진행 상황 확인
  • 오류 메시지가 있는지 대화 내용 확인

7.3 원하는 대로 구현되지 않았어요

무엇이 마음에 들지 않는지와 원하는 결과를 함께 알려 줍니다.

[마음에 들지 않는 점]을 고쳐주세요.
[원하는 결과]처럼 되면 좋겠습니다.

8. 다음 단계

파일이 생성되었으면 Browser에서 실제로 동작하는지 테스트해봅시다.

Browser로 테스트하기

마지막 수정