자동화 프로젝트 단계별 가이드: AI 계획부터 YAML 오류 해결까지
2026.08.01
6일차 — 세부계획 짜다가 세 번 뒤통수 맞고, 그때마다 직접 확인해서 잡은 하루
한 줄 요약: PRD를 세부계획으로 쪼개는 것부터 시작해서, AI가 짜준 계획을 그대로 안 믿고 "조사부터"를 붙였더니 Make의 숨은 한계를 미리 찾아냈고, 검색으로 찾은 RSS 주소도 직접 열어봐서 틀린 걸 잡았고, 마지막엔 배포까지 "됐다"는 말만 믿지 않고 실제 화면·로그를 열어봐서 진짜 원인(YAML 오류)까지 잡아낸 하루였습니다.
누구에게 도움이 될까: AI가 짜준 계획·"됐다"는 말을 그대로 믿어도 되는지 궁금한 초보자, 자동화 프로젝트를 세부계획 단계로 넘어가려는 사람, "예전엔 됐는데 오늘은 왜 안 되지?"를 겪어본 사람.
Before
5일차에 PRD(제품 요구사항 문서)를 완성했습니다. 6일차 과제는 그걸 실제로 만드는 순서(세부계획)로 쪼개는 것이었는데, 막상 시작하려니 걱정이 하나 있었습니다. 제 프로젝트는 "자동으로 요약해서 웹페이지에 올리기"까지 해야 하는데, 그 마지막 단계를 어떻게 구현할지 전혀 감이 없었습니다. AI한테 그냥 "계획 짜줘"라고 하면 예전 방식대로 답할 수도 있겠다는 생각도 들었습니다.
계획 수립 방법
1) 계획 짜기 전에 "요즘 제일 쉬운 방법"부터 조사시키기
어제 만든 PRD를 바탕으로 세부계획을 세우고 싶어. 단, 계획을 짜기 전에 먼저 조사부터 해줘 — 이걸 지금 만든다면 요즘 제일 쉽고 많이 쓰는 방법이 뭔지 최신 기준으로 찾아봐. (옛날 방식이 아니라, 지금 초보가 제일 적은 노력으로 만들 수 있는 방법으로.) 그 최신 방법을 바탕으로 세부계획을 세워줘. 나는 코딩을 잘 몰라. 4주 안에 진짜 만들 수 있게, 작은 단계로 잘게 쪼개서 순서대로 정리해줘. 각 단계는 "하루 안에 될 만한 크기"로.이 한 문장 덕분에 뜻밖의 걸 발견했습니다. 자동화 도구(Make)의 깃허브 연동 기능을 실제로 찾아보니, 이슈·댓글·브랜치 관리는 되지만 "파일을 새로 만드는" 기능 자체가 없었습니다. 즉 자동으로 만든 요약을 제 사이트 파일로 직접 쓰는 건 원래부터 불가능한 방법이었던 겁니다. 조사 없이 계획부터 짰다면 나중에 한참 헤맸을 지점을, AI가 구글 스프레드시트를 중간 저장소로 쓰는 대안까지 찾아서 미리 알려줬습니다.
2) 세부계획의 첫 단계 — 튜토리얼로 쪼개서 따라가기
세부계획이 나온 뒤, 제일 작은 첫 단계 하나를 튜토리얼로 풀어달라고 했습니다.
방금 세운 세부계획에서 제일 먼저 할 작은 단계 하나를 골라줘. 그걸 내가 그대로 따라 만들 수 있게, 한 단계씩 튜토리얼로 풀어줘. 각 단계마다 "이럴 땐 이 프롬프트로 AI한테 시켜"까지 알려줘. 나는 초보니까, 막히기 쉬운 데는 "여기서 이렇게 물어봐"도 같이 넣어줘.RSS·API·웹훅 같은 낯선 개념부터, 일상 비유(신문 구독·식당 주문 창구·초인종)로 이해하고, 그걸 제 프로젝트에 연결해서 확인한 뒤 위키 개념페이지로 저장했습니다.
3) 검색으로 찾은 정보도 직접 확인 — RSS 주소가 문서와 달랐다
세부계획의 실행 단계로 AI 뉴스 RSS 후보 사이트를 찾았는데, 검색 결과로 나온 주소가 실제로는 안 먹혔습니다.
http://www.aitimes.kr/rss/ 주소로는 접속이 안돼. https://www.aitimes.kr/로는 가능해직접 열어보고 나서야 진짜 주소(https://www.aitimes.kr/rss/allArticle.xml)를 찾을 수 있었습니다. 검색 결과 문서 하나만 믿었으면 틀린 주소를 그대로 썼을 뻔했습니다.
4) "배포해줘"라고 했는데, 이번엔 AI 혼자 못 하는 상황
오늘 만든 글들을 정리해서 사이트에 올려달라고 했습니다.
지피터스에 올릴 사례글 필요해. 커밋 후 배포도 해주고 내 학습메이트 싸이트에그런데 이번엔 AI가 로컬 커밋까지만 하고, push(깃허브에 실제로 올리는 것) 단계에서 멈췄습니다. 이 환경엔 깃허브 로그인 정보가 없다는 이유였습니다. GitHub Desktop이라는 프로그램을 새로 설치하고, 로그인하고, push 버튼을 눌렀는데도 사이트엔 반영이 안 됐습니다.
5일차까지는 됬었는데 왜 오늘 안되?이렇게 캐물어서 알아낸 건, 예전엔 AI가 직접 깃허브에 연결돼 push까지 했었는데 지금 이 대화창은 그 연결이 없어서 사람이 직접 눌러야 했다는 것이었습니다.
5) push는 됐는데 사이트는 그대로 — 로그까지 열어서 진짜 원인 찾기
깃허브에는 커밋이 올라간 게 확인됐는데 사이트는 갱신되지 않았습니다. Vercel(배포 서비스) 대시보드를 열어보니 최신 배포가 여전히 3일 전 것이었고, 커밋 옆에 빨간 X(체크 실패) 표시가 있었습니다. 로그를 열어보니:
can not read a block mapping entry; a multiline key may not be an implicit key Location: .../w1-case-day6.md:4:2사례글 파일의 요약(summary) 값이 큰따옴표(")로 시작해서 YAML 형식이 깨져 있었고, 이 파일 하나 때문에 사이트 전체 빌드가 실패하고 있었습니다.
응 자꾸 반복되는데 다음에는 안그러게 할 수 있어?따옴표를 고치고, 같은 실수가 반복되지 않도록 프로젝트 규칙 문서에 "요약이 큰따옴표로 시작하면 작은따옴표로 감싼다"는 규칙을 아예 적어뒀습니다. 다시 push하니 초록색 체크로 빌드가 통과됐습니다.
6) 이후엔 액세스 토큰으로 반복 작업을 줄임
매번 GitHub Desktop을 열어 push하는 게 번거로워서, 이 저장소 전용 액세스 토큰을 발급받아 AI한테 전달했습니다. 그다음부턴 "커밋하고 배포해줘"라고만 하면 push까지 한 번에 끝나게 됐습니다.
After
Make로는 안 되는 부분을 미리 알아채고 더 쉬운 방법으로 바꿨습니다.
검색으로 찾은 정보(RSS 주소)를 직접 확인해서 틀린 부분을 잡았습니다.
"배포됐다"는 말만 믿지 않고 사이트·깃허브·빌드 로그까지 직접 확인해서, 진짜 원인(YAML 오류)을 찾아 고쳤습니다.
반복되는 문제(push 매번 수동으로 하기)는 액세스 토큰으로 구조 자체를 바꿔서 해결했습니다.
배운 것 / 재사용 자산
계획을 짜달라고 할 때 "먼저 조사부터"를 붙이면, AI가 실제 문서를 찾아서 확인한 뒤 답합니다. 나중에 막힐 자리를 미리 없애줍니다.
검색·문서로 찾은 정보(URL, 명령어)는 AI 말만 믿지 않고 직접 열어서 확인하는 게 안전합니다.
"됐다"는 결과는 눈에 보이는 화면(사이트, 깃허브, 빌드 로그)으로 직접 확인해야 진짜 끝난 겁니다.
같은 실수가 반복되면, 그때그때 고치기보다 프로젝트 규칙 문서에 적어두면 다음번엔 반복을 막을 수 있습니다.
매번 반복되는 번거로운 작업은 "왜 매번 이래야 하지?"라고 물어보면, 구조를 바꿔서 줄일 방법(이번엔 액세스 토큰)이 나올 수 있습니다.
재사용 프롬프트 모음:
[하려는 것]을 하고 싶어. 계획 짜기 전에 먼저 조사부터 해줘 — 지금 기준으로 제일 쉽고 많이 쓰는 방법이 뭔지 찾아봐. 그 방법대로 만들 때 안 되는 부분이 있는지도 미리 확인해줘.진짜 반영된 거 맞아? 실제 화면/사이트에서 확인해봐.전엔 됐는데 왜 지금은 안 돼? 환경이 달라진 건 없어?이거 자꾸 반복되는데, 다음엔 안 그러도록 프로젝트 규칙에 적어둬줄 수 있어?로그인하고 댓글을 남겨 주세요
제리님 민철님도 rss주소 언급하셨는데
찾아보니 "웹사이트의 새로운 콘텐츠나 업데이트 정보를 사용자가 일일이 방문하지 않고도 한곳에서 모아볼 수 있게 해주는 콘텐츠 표현 방식"이군요 저도 하나 배워가요^^



제대로 작업할수 있게 조사해보고 찾아보셨군요. 막상 조사해보면 생각과는 다른경우도 많지요. 그래서 하고자 하는게 어느정도 있다면 로드맵 초반부터도 조사를 하고 들어가기도 해요. 처음부터 오픈소스와, 스킬등 이미 있는게 있다면 최대한 반영하기도 하고요.