00. 시작하기

이 가이드에서 만드는 것

AI-native 개발은 모든 판단을 AI에게 넘기는 방식이 아닙니다. 사람은 원하는 상태 변화, 지켜야 할 경계, 완료를 판단할 증거를 정합니다. 에이전트는 그 경계 안에서 저장소를 살펴보고, 변경하고, 검증 결과를 다음 판단에 반영합니다.

이 가이드의 순서는 다음과 같습니다.

1. 문제와 완료 조건
2. 필요한 컨텍스트
3. 안전한 실행 환경
4. 에이전트 작업 실행
5. 증거 기반 검증 루프
6. 결정과 학습 기록
7. 배포와 운영

각 단계는 목표 → 핵심 설명 → 체크리스트 → 직접 해보기 → 완료 근거로 구성됩니다. 처음부터 순서대로 따라가거나, 현재 필요한 단계와 Recipes만 골라 볼 수 있습니다.

연습 작업 준비하기

되돌리기 쉬운 작은 기능을 고릅니다. 이 가이드에서는 전송 중인 문의 폼에서 같은 요청이 중복 제출되지 않게 한다는 가상 작업을 예로 사용합니다. 실제 운영 사례가 아니며, 운영 데이터와 자격 증명 없이 로컬 또는 테스트 환경에서 연습합니다.

현재 상태:
원하는 상태:
연습할 저장소와 화면:
이번 작업에서 건드리지 않을 것:

변경하기 전에 git status, 기본 테스트, 로컬 화면을 확인해 기준점을 남깁니다. 이 기록은 이후 실패가 원래부터 있던 문제인지 새 변경 때문인지 구분하는 근거가 됩니다.

시작 체크리스트

• Git으로 변경 전후를 확인할 수 있습니다.
• 저장소의 작업 규칙과 기본 검증 명령을 찾았습니다.
• 운영 비밀값이나 실제 사용자 데이터가 필요 없는 작업을 골랐습니다.
• 현재 동작과 원하는 동작을 각각 한 문장으로 설명할 수 있습니다.
• 실패하더라도 원래 상태로 돌아갈 방법을 알고 있습니다.

완료 근거

• 기준점이 되는 테스트 또는 빌드 결과가 있습니다.
• 현재 동작을 재현하는 화면이나 절차가 있습니다.
• 연습 범위와 제외 범위를 설명할 수 있습니다.
• 운영 시스템에 영향을 주지 않고 다음 단계로 진행할 수 있습니다.

Prompt, Context, Harness, Loop의 관계를 먼저 깊게 보고 싶다면 프롬프트에서 루프까지 아티클을 함께 읽어보세요.

다음은 해결 방법보다 먼저 도착점을 정하는 01. 문제와 완료 조건입니다.