AI로 웹사이트 만들 때, 맡길 일과 직접 확인할 일
목차 보기
AI에게는 초안·파일 수정·반복 검사를 맡기고, 사람은 목적·작업 범위·사실 확인·공개 여부를 결정하는 방식으로 시작할 수 있습니다. 예를 들어 AI가 홈페이지 제목을 바꿔도, 내가 원한 문구인지와 실제 사이트에 올릴지는 직접 확인합니다.
모든 코드를 읽거나 명령어를 외워야 한다는 뜻은 아닙니다. 무엇을 바꾸려는지, 어디까지 맡길지, 어떤 결과를 보고 끝낼지를 정하면 됩니다. 아래는 minml을 만들고 운영하며 사용한 역할 구분입니다.
단계별로 무엇을 맡기면 될까
사이트 작업을 기획 → 제작 → 검증 → 공개로 나누면 판단할 지점이 분명해집니다. 검증은 원하는 결과가 나왔는지 확인하는 일이고, 공개를 위한 배포는 수정한 파일을 실제 사이트에 올리는 일입니다.
| 단계 | AI에게 맡길 일 | 직접 확인할 일 |
|---|---|---|
| 기획 | 기존 파일 조사, 구조와 디자인 제안 | 누구를 위한 사이트인지, 어떤 기능이 필요한지 |
| 제작 | 문장·코드 초안, 요청한 파일 수정 | 내용이 맞는지, 원하는 방향으로 바뀌었는지 |
| 검증 | 오류·링크 검사, 변경 전후 비교 | 요청과 다른 변경이 없는지, 실제 화면이 읽기 쉬운지 |
| 공개 | 정해 둔 절차에 따른 업로드와 상태 확인 | 공개할 시점, 공개해도 되는 정보, 실패할 때 되돌릴 방법 |
처음부터 사이트 전체를 맡기기보다 눈으로 결과를 확인할 수 있는 작은 작업부터 시작하면 이 구분을 익히기 쉽습니다.
제목 하나를 바꾸는 예시
다음은 방법을 이해하기 위한 설명용 요청입니다. 홈페이지 제목을 바꾸는 상황이라면 요청과 확인을 이렇게 나눌 수 있습니다.
1. 바꿀 것과 그대로 둘 것을 함께 말하기
홈페이지 제목을 ‘Simply AI’로 바꿔줘. 제목 문구만 수정하고 글꼴, 배치, 다른 문장은 그대로 둬. 바꾼 파일과 확인 방법을 알려줘.
‘사이트를 깔끔하게 만들어줘’보다 결과를 비교하기 쉽습니다. AI는 관련 파일을 찾아 문구를 바꾸고, 사람은 바꾸려던 대상이 맞는지 확인합니다. 파일 이름을 모른다면 수정 전에 제목이 어디에 있는지 설명해 달라고 요청해도 됩니다.
2. 바뀐 파일과 검사 결과 보기
작업이 끝나면 다음처럼 물어볼 수 있습니다.
무엇을 바꿨는지 수정 전후로 보여줘. 요청과 관계없는 변경이 있는지 확인하고, 이 프로젝트에 있는 검사도 실행해줘.
수정 전후를 비교하는 화면을 diff라고 합니다. 모든 코드를 해석하기보다 요청한 문구가 바뀌었는지, 다른 페이지나 기능까지 건드렸는지부터 봅니다.
‘검사 통과’라는 답을 받았다면 무엇을 검사했는지도 확인합니다. 빌드는 프로젝트 파일을 실제 사이트로 만드는 과정입니다. 빌드 성공은 그 과정이 끝났다는 뜻이지, 내가 원한 문구나 배치까지 맞다는 뜻은 아닙니다.
3. 실제 화면에서 확인하기
미리보기에서 새 제목이 보이는지, 휴대폰 너비에서도 잘리지 않는지 확인합니다. 원하지 않은 변경이 보이면 ‘모바일에서 제목의 마지막 글자가 잘려’처럼 증상을 구체적으로 전달합니다.
확인이 끝나면 다음 작업으로 넘어갑니다. Claude Code에서 시작하는 화면과 첫 요청 순서는 클로드 코드 사용방법에서 이어 볼 수 있습니다.
검사가 통과해도 요청과 다를 수 있습니다
검사는 정해 둔 조건을 확인합니다. 예를 들어 파일이 만들어지고 링크가 정상이어도, 제목을 바꾸다가 메뉴 이름까지 수정했다면 요청 범위를 벗어난 결과입니다.
사람이 확인할 질문은 두 가지입니다.
- 원한 결과가 나왔나? 제목 문구, 디자인, 기능을 요청과 비교합니다.
- 그 밖에 무엇이 바뀌었나? 기존에 직접 수정한 내용이나 다른 페이지에 영향을 줬는지 봅니다.
AI에게 파일 변경 목록과 이유를 설명하게 하면 어디부터 볼지 정하기 쉽습니다. 중요하게 지켜야 할 조건은 반복 검사로 남길 수도 있습니다. 같은 규칙을 매번 설명하는 일이 늘었다면 하네스와 규칙 파일을 참고할 수 있습니다.
검토 후 결과를 채택하지 않기로 했다면 내 수정은 남기고 AI 변경을 되돌리는 방법에서 파일 상태별로 확인합니다.
잘 읽히는 문장도 사실을 확인해야 합니다
AI가 사이트 소개나 글 초안을 쓰더라도 가격·기능·지원 환경은 공식 자료와 맞춰 봅니다. 내가 겪지 않은 일을 자연스러운 사용기로 써 놓았다면 실제 경험으로 발행할 수 없습니다.
예를 들어 ‘홈페이지가 열렸다’는 결과로 ‘서버 전체가 안전하다’고 말할 수는 없습니다. 작업 시간을 재지 않았다면 ‘10분 만에 완성했다’는 수치도 붙이지 않습니다.
AI에게 먼저 확인할 주장과 출처를 정리하게 할 수 있지만, 출처가 그 문장을 뒷받침하는지는 다시 읽어야 합니다. 실제 오류를 나눠 확인하는 방법은 AI가 쓴 기술 글의 사실 확인에 정리했습니다.
파일 수정과 실제 공개는 별개입니다
컴퓨터에서 파일을 고쳤다고 방문자가 보는 사이트까지 바로 바뀌는 것은 아닙니다. Git을 쓰는 프로젝트에서 커밋은 변경 기록을 남기는 일, 배포는 그 결과를 실제 사이트에 올리는 일입니다.
공개 전에 화면과 내용을 확인하고, 계정 정보·개인 연락처·서버 접속 정보처럼 공개할 필요 없는 값이 글이나 이미지에 남지 않았는지도 봅니다. 발행 전 보안 검토는 사실 확인과 따로 진행합니다.
파일 삭제나 운영 서버 설정 변경이 필요하다면 대상과 영향, 되돌릴 방법을 먼저 확인합니다. AI가 명령을 실행할 수 있다는 사실만으로 그 변경을 하기로 결정한 것은 아닙니다. 서버에 접속하는 작업의 구체적인 확인 항목은 AI에게 SSH 작업을 맡기는 기준에서 다룹니다.
실제 문제에서 바뀐 확인 기준
minml에서도 AI가 작업을 끝냈다는 답만으로 충분하지 않았습니다. 실제로 겪거나 발견한 문제를 다음 작업의 확인 기준으로 남겼습니다.
| 실제 문제 | 이후 확인한 것 |
|---|---|
| 깨진 내부 링크가 있어도 빌드가 성공함 | 생성된 페이지의 링크를 별도로 검사 |
| 사이트는 열렸지만 배포 파일 권한이 불필요하게 넓었음 | 공개 전에 파일 권한 검사 |
| 기술 글에서 운영 정보가 노출될 위험이 있었음 | 본문·명령 출력·이미지를 함께 검토 |
자세한 과정은 깨진 링크 검사와 파일 권한을 바로잡은 기록에 있습니다. 이 사례들은 완료로 판단할 기준을 구체적으로 정해야 한다는 것을 보여줬습니다.
배포 순서와 실패할 때 되돌리는 방법은 새 릴리스로 교체하는 배포로 이어집니다. 이 글에서는 작은 요청부터 시작해 바뀐 파일·검사 결과·실제 화면을 함께 확인하는 순서를 먼저 익히면 됩니다.