Agents & coding

에이전트 · 코딩 AI

에이전트에게 맡길 일과 사람이 멈춰 세울 때를 나눕니다. 작업을 쪼개는 법, 규칙 파일에 적을 것, 보안 주의점을 정리했습니다.

Delegate

맡기기 좋은 일, 아닌 일

작고 확인하기 쉬운 일일수록 맡기기 좋습니다.

항목맡기기 좋음검토 필요사람이 직접
예작은 수정, 반복 변환, 테스트 작성여러 파일에 걸친 기능 추가큰 설계 변경, 보안 설정
확인 방법테스트 · 실행 결과변경 내용 하나씩 읽기사람이 결정하고 기록
실패했을 때되돌리기 쉬움부분만 되돌림피해가 큼
멈춰 세울 신호같은 실패 반복범위 밖 파일 수정외부로 나가는 일

사람이 언제 멈춰 세우는지는 사람은 AI를 언제 멈춰 세우는가에 정리했습니다.

Split

작업을 쪼개는 방법

비개발자가 막히는 지점은 대부분 한 번에 너무 큰 일을 맡길 때입니다. 막히는 3가지 이유

  1. 01

    목표 한 줄

    무엇이 되면 끝인지 한 문장으로 씁니다.

  2. 02

    확인 기준

    끝났다는 것을 무엇으로 확인할지 정합니다.

  3. 03

    작은 단위로

    한 번에 확인할 수 있는 크기로 나눕니다.

  4. 04

    단위마다 확인

    결과를 직접 실행해 보고 다음으로 갑니다.

  5. 05

    다음 단위

    앞 단계의 결과를 기록하고 이어 갑니다.

Rules

규칙 파일에 적을 것

규칙 파일이 줄이려는 실수는 대부분 범위와 확인에 관한 것입니다. 규칙 파일이 줄이는 실수 4가지

  • 하지 말 것건드리면 안 되는 파일 · 명령
  • 확인 방법테스트 · 빌드 · 실행 명령
  • 고칠 범위요청한 것만, 주변 정리는 묻고 나서
  • 스타일 맞추기기존 코드의 꼴을 따름
  • 끝났다고 말할 조건확인 결과를 보여 준 뒤에만
  • 모를 때추측하지 말고 물어보기

Memory

맥락을 잊지 않게 하는 구조

대화가 길어지면 AI 는 앞의 결정을 잊습니다. 기억을 채팅 밖에 둡니다. 기억 저장 구조

  • 01

    채팅 밖 기록 파일

    결정한 것과 이유를 파일에 적어 다음 대화에서 읽게 합니다.

  • 02

    진행 상황 메모

    어디까지 했고 다음에 무엇을 할지 짧게 남깁니다.

  • 03

    다시 찾기 쉬운 이름

    파일과 항목 이름만 보고도 찾을 수 있게 짓습니다.

  • 04

    요약보다 원문 링크

    요약은 빠뜨리기 쉬우니 원문 위치를 함께 남깁니다.

Note

에이전트 보안 주의

에이전트가 읽는 문서 · 이슈 · 웹 페이지 안의 지시는 사용자의 지시가 아닙니다. 실제로 사람을 속여 저장소에 접근하려던 사례도 있었습니다. 사례 보기

  • — 권한은 작게, 필요한 만큼만 줍니다.
  • — 바깥으로 나가는 일(배포 · 게시 · 결제)은 사람이 확인합니다.
  • — 비밀 값은 에이전트가 읽는 곳에 두지 않습니다.

FAQ

에이전트 자주 묻는 질문

비개발자도 바이브코딩을 할 수 있나요?

할 수 있습니다. 다만 결과를 직접 실행해 확인할 수 있는 크기로 쪼개야 합니다. 비개발자 바이브코딩이 막히는 3가지 이유와 작업을 쪼개는 방법

명령을 길고 자세하게 쓰면 더 낫나요?

길어질수록 놓치는 항목이 늘어납니다. 짧은 명령과 별도의 확인 기준이 낫습니다. 명령이 길어질수록 AI는 더 자주 틀린다

어떤 모델을 써야 하나요?

모델보다 작업을 쪼개는 방식이 결과를 더 크게 바꿉니다. 모델 소식은 모델 · 소식에 모았습니다.

코딩 AI 글 모아 보기

에이전트와 코딩 AI 를 직접 써 본 기록을 모았습니다. 제보는 문의하기로 받습니다.