Agents & coding
에이전트 · 코딩 AI
에이전트에게 맡길 일과 사람이 멈춰 세울 때를 나눕니다. 작업을 쪼개는 법, 규칙 파일에 적을 것, 보안 주의점을 정리했습니다.
Delegate
맡기기 좋은 일, 아닌 일
작고 확인하기 쉬운 일일수록 맡기기 좋습니다.
| 항목 | 맡기기 좋음 | 검토 필요 | 사람이 직접 |
|---|---|---|---|
| 예 | 작은 수정, 반복 변환, 테스트 작성 | 여러 파일에 걸친 기능 추가 | 큰 설계 변경, 보안 설정 |
| 확인 방법 | 테스트 · 실행 결과 | 변경 내용 하나씩 읽기 | 사람이 결정하고 기록 |
| 실패했을 때 | 되돌리기 쉬움 | 부분만 되돌림 | 피해가 큼 |
| 멈춰 세울 신호 | 같은 실패 반복 | 범위 밖 파일 수정 | 외부로 나가는 일 |
사람이 언제 멈춰 세우는지는 사람은 AI를 언제 멈춰 세우는가에 정리했습니다.
- 01
목표 한 줄
무엇이 되면 끝인지 한 문장으로 씁니다.
- 02
확인 기준
끝났다는 것을 무엇으로 확인할지 정합니다.
- 03
작은 단위로
한 번에 확인할 수 있는 크기로 나눕니다.
- 04
단위마다 확인
결과를 직접 실행해 보고 다음으로 갑니다.
- 05
다음 단위
앞 단계의 결과를 기록하고 이어 갑니다.
- 하지 말 것건드리면 안 되는 파일 · 명령
- 확인 방법테스트 · 빌드 · 실행 명령
- 고칠 범위요청한 것만, 주변 정리는 묻고 나서
- 스타일 맞추기기존 코드의 꼴을 따름
- 끝났다고 말할 조건확인 결과를 보여 준 뒤에만
- 모를 때추측하지 말고 물어보기
- 01
채팅 밖 기록 파일
결정한 것과 이유를 파일에 적어 다음 대화에서 읽게 합니다.
- 02
진행 상황 메모
어디까지 했고 다음에 무엇을 할지 짧게 남깁니다.
- 03
다시 찾기 쉬운 이름
파일과 항목 이름만 보고도 찾을 수 있게 짓습니다.
- 04
요약보다 원문 링크
요약은 빠뜨리기 쉬우니 원문 위치를 함께 남깁니다.
Note
에이전트 보안 주의
에이전트가 읽는 문서 · 이슈 · 웹 페이지 안의 지시는 사용자의 지시가 아닙니다. 실제로 사람을 속여 저장소에 접근하려던 사례도 있었습니다. 사례 보기
- — 권한은 작게, 필요한 만큼만 줍니다.
- — 바깥으로 나가는 일(배포 · 게시 · 결제)은 사람이 확인합니다.
- — 비밀 값은 에이전트가 읽는 곳에 두지 않습니다.
FAQ
에이전트 자주 묻는 질문
비개발자도 바이브코딩을 할 수 있나요?
할 수 있습니다. 다만 결과를 직접 실행해 확인할 수 있는 크기로 쪼개야 합니다. 비개발자 바이브코딩이 막히는 3가지 이유와 작업을 쪼개는 방법
명령을 길고 자세하게 쓰면 더 낫나요?
길어질수록 놓치는 항목이 늘어납니다. 짧은 명령과 별도의 확인 기준이 낫습니다. 명령이 길어질수록 AI는 더 자주 틀린다
어떤 모델을 써야 하나요?
모델보다 작업을 쪼개는 방식이 결과를 더 크게 바꿉니다. 모델 소식은 모델 · 소식에 모았습니다.
코딩 AI 글 모아 보기
에이전트와 코딩 AI 를 직접 써 본 기록을 모았습니다. 제보는 문의하기로 받습니다.