실전 템플릿 모음──Plan, Work, Review, Compound를 그대로 복사해서 사용하기 제8회

지금까지 AI 에이전트 (AI Agent)를 개발 공정에 넣는 방법을 나누어 작성해 왔습니다.

Plan.

Work.

Review.

Compound.

sandbox.

tools.

조사.

Codex App.

이번에는 템플릿 모음입니다.

생각하는 방식만으로는 매일의 작업으로 돌아가기 어렵습니다.

그래서 바로 붙여서 사용할 수 있는 형태로 만듭니다.

그대로 사용해도 좋고, 자신의 리포지토리 (Repository)에 맞춰서 깎아내도 좋습니다.

템플릿은 매번 전부 사용하는 것이 아닙니다.

태스크 (Task)에 맞춰 선택합니다.

조사만 하고 싶다 -> read-only investigation
사양을 정리하고 싶다 -> spec draft
작게 구현하고 싶다 -> limited implementation
...

중요한 것은 처음부터 구현으로 뛰어넘지 않는 것입니다.

이 태스크는 read-only 조사입니다.
아직 파일을 변경하지 마세요.
목적:
...

아직 구현하지 마세요.
먼저 구현 Plan만 만들어 주세요.
목적:
...

다음 요구사항으로부터 AI 에이전트 (AI Agent)에게 전달할 사양서를 만들어 주세요.
요구사항:
- `<요구사항을 작성>`
...

다음 범위만 구현해 주세요.
목적:
- `<목적>`
...

아직 구현을 변경하지 마세요.
먼저 이번 버그를 재현하는 failing test만 추가해 주세요.
출력:
...

이것은 장애 조사입니다.
아직 수정하지 마세요.
입력:
...

다음 로그를 읽어 주세요.
원인 단정은 아직 하지 마세요.
출력:
...

이 diff를 review 해 주세요.
확인할 것:
- 사양에 맞는지
...

이 화면을 review 해 주세요.
아직 수정하지 마세요.
확인할 것:
...

외부 tool을 사용하기 전에 다음을 출력해 주세요.
- tool name
- 조작 내용
...

DB를 read-only로 조사해 주세요.
허가:
- staging DB
...

PR 코멘트의 draft를 만들어 주세요.
게시(Post)는 하지 마세요.
포함할 것:
...

이번 작업으로부터 AGENTS.md에 되돌려야 할 규칙을 제안해 주세요.
분류할 것:
- repo-wide rule
...

이번 작업을 Compound Note로 만들어 주세요.
형식:
## What happened
...

이 project를 read-only로 조사해 주세요.
아직 변경하지 마세요.
출력:
...

이 화면과 메모로부터 개발자에게 전달할 버그 보고를 만들어 주세요.
포함할 것:
- 무엇을 하려고 했는지
...

이 작업을 AI 에이전트 (AI Agent)에게 맡겨도 될지 판정해 주세요.
확인할 것:
- 실패 시의 영향
...

작업 종료 전에 확인해 주세요.
- diff가 목적에 맞는지
- unrelated change는 없는지
...

템플릿은 에이전트 (Agent)를 구속하기 위한 것만이 아닙니다.

인간의 판단을 편하게 하기 위한 것입니다.

매번 같은 설명을 하지 않는다.

매번 같은 실패를 보지 않는다.

매번 같은 review를 하지 않는다.

자주 사용하는 의뢰는 템플릿으로 만든다.

반복되는 확인은 checklist로 만든다.

매번 적용하고 싶은 규칙은 AGENTS.md로 되돌린다.

이 흐름이 가능해지면, AI 에이전트 (AI Agent)는 단발적인 도구가 아니라 개발 공정 속에서 다룰 수 있는 작업자가 됩니다.