코딩 몰라도 일주일 만에 "생각"을 "결과물"로 만든 이야기
2026.08.06
한 줄 요약
코딩·개발을 하나도 모르는 상태로 시작해서, 일주일 만에 나만의 AI 학습메이트('하루')를 만들고, 사이트를 실제 인터넷 주소로 배포하고, PRD·세부계획을 세우고, 진짜 데이터가 자동으로 갱신되는 파이프라인 하나까지 완성했다.
누구에게 도움이 될까
“나도 AI로 뭔가 만들어보고 싶은데 코딩을 전혀 모른다”는 사람.
처음부터 끝까지 막힌 지점과 그걸 넘긴 방법을 그대로 남겼다.
첫 날은 도구를 갖추는 날이었다. 나(john)의 AI 학습메이트 “하루”를 만드는 것부터 시작했다 — SOUL.md(성격)·USER.md(나에 대한 정보)·AGENTS.md(작업 규칙)·CLAUDE.md(입구) 4개 파일을 인터뷰로 채웠다. 그다음 이 사이트를 내 컴퓨터에서 처음 띄워봤다. Node.js가 있는지 확인하고, 필요한 걸 설치하고, 미리보기 서버를 켜는 것까지 — 전부 하루가 대신 해줬다.
그날 오후엔 GPTers에 올라온 ARIA(멀티 에이전트 투자 어시스턴트) 사례를 읽고, 여기서 처음 나온 개념 8개(에이전트·오케스트레이터·병렬 실행·MCP 등)를 개념페이지로 정리했다. “AI 투자 보조 인프라”라는 방향이 이때 처음 잡혔다.
재사용 프롬프트: “이 사례 글 읽고, 여기 나온 낯선 개념들을 쉽게 풀어서 개념페이지로 정리해줘.”
로드맵을 좁히고, 처음으로 인터넷에 올리다
이틀 뒤, “AI 투자 정보 인프라”라는 큰 방향을 반도체 섹터 파일럿으로 좁혔다. 처음 떠올린 아이디어는 “모든 국가·모든 섹터·모든 주기”였는데, 인터뷰를 거치며 4주 안에 되는 크기로 좁히는 연습을 했다. 이 좁히는 과정 자체가 이번 주의 첫 번째 배움이었다 — “일단 다 하고 싶다”를 “4주 안에 되는 크기”로 깎는 것.
같은 날 GitHub·Vercel 계정을 처음 만들고, 사이트를 실제로 배포했다. 인터넷 주소가 생긴 첫 순간이었다. GitHub CLI·Vercel CLI 로그인이 둘 다 “기기 코드를 브라우저에 입력하는 방식”이라는 것도 이때 처음 알았는데, 이 패턴은 나중에 GitHub Actions 권한을 승인할 때도 똑같이 다시 나왔다.
보안이 걱정돼서 “AI가 다른 폴더를 마음대로 건드릴 수 있는지”, “해킹당할 여지가 있는지”도 이날 처음 물어봤다. 이 질문이 자동 보안점검 루틴을 만드는 것으로 이어졌다.
되돌리기를 몸으로 익히다
일부러 랜딩페이지 첫 문장을 망가뜨리고, git restore로 되돌리는 연습을 했다. 커밋 = 게임의 세이브포인트 라는 비유로 이해했고, “완성된 결과물 단위로 묶어서 커밋한다”는 기준도 이때 합의했다. 작아 보이지만, 이 감각이 있어야 이후에 겁 없이 코드를 계속 고칠 수 있었다.
PRD를 짜고, 그 과정 자체를 자동화하다
로드맵의 “만들기”를 3주차에서 1주차로 앞당기기로 하고, PRD(제품 요구사항 문서)를 인터뷰로 구체화했다. 예시를 보여주며 하나씩 물어보는 방식이 왜 필요한지 이날 체감했다 — 로드맵과 달리 PRD는 정해진 틀이 없어서, “글로벌 자산 = 지수냐 개별종목이냐” 같은 애매한 지점마다 판단이 필요했다.
기술 스택을 정할 때도 “옛날 방식 말고 지금 초보 기준”으로 다시 조사해달라고 했고, GitHub Actions + JSON 조합이 지금 이 사이트(Astro+Vercel) 구조에 제일 간단하다는 결론을 얻었다. 이 PRD 만드는 과정 자체를 스킬로 만들어서, 다음번엔 “PRD 만들어줘” 한마디로 오늘 한 과정이 그대로 실행되게 해뒀다.
위키가 두서없어진 걸 발견하고 바로잡다
PRD와 4주 실행계획을 저장한 뒤 “제목부터 순서까지 두서없다”는 느낌이 들었다. 코드를 열어보니 진짜 원인이 있었다 — 로드맵이라는 분류가 “전체 지도” 자리에 딱 1개만 고정되게 설계돼 있었는데, PRD·실행계획도 실수로 같은 분류를 써서 그 자리에 3개가 겹쳐 나온 거였다. 새 분류 계획을 만들고, 모든 글 제목을 “N주차 종류 — 내용” 형식으로 통일했다. “느낌이 이상하다”는 말은 대부분 코드 어딘가에 실제 원인이 있다는 걸 배웠다.
첫 데이터 파이프라인, 진짜로 자동화까지
이번 주 마지막 날, 드디어 진짜 데이터를 다뤘다. FRED(미국 경제데이터) 계정을 만들고 API 키를 발급받아, 미국 기준금리를 가져와 화면에 띄우는 코드를 만들었다.
재사용 프롬프트: “[API 이름]에서 [지표]를 가져와서 JSON으로 저장하는 스크립트 만들고, 그 값을 카드로 보여주는 화면도 만들어줘.”
로컬에서 실행하다가 설정 파일 이름을 살짝 잘못 저장해서 한 번 막혔고, GitHub에 자동화 코드를 올릴 때는 workflow 권한이 없어서 또 한 번 막혔다. 둘 다 “권한을 다시 승인”하거나 “이름을 정확히 고치는” 걸로 풀렸다 — 큰 개념이 어려웠다기보다, 도구 사용법의 디테일에서 막힌 경우가 많았다.
결국 GitHub Actions를 수동으로 한 번 실행해봤고, 내가 아니라 자동화가 스스로 커밋을 만든 것을 확인했다. 그 여운으로, 매주 자동으로 보안 상태를 점검해주는 클라우드 루틴까지 예약해뒀다 — 계정 로그인이 필요한 부분은 못 보게 범위를 딱 잘라두고서.
곁가지: 이번 주에 정리한 AI 생태계 구조
(초보 입장에서 도움 될 것 같아 남김)
이번 주 사이사이, Claude Code·GitHub·Vercel·MCP 같은 이름들이 계속 나오는데 이게 서로 경쟁 관계인지 같이 쓰는 건지 헷갈렸다. 그래서 전체를 층(레이어)으로 나눠서 정리했다. 결론은 한 줄이다 — 같은 층에 있는 것끼리는 경쟁(하나만 고름), 다른 층에 있는 것끼리는 협력(같이 씀).
층 | 하는 일 | 이번 주 실제로 쓴 것 |
|---|---|---|
1층 · 기반 모델 | AI의 두뇌. 위 모든 도구가 이걸 빌려 씀 | Claude |
2층 · 코딩 에이전트 | 시키면 알아서 파일 생성·수정·배포까지 끝까지 함 | Claude Code |
3층 · 코드 에디터 | 사람이 코드를 직접 보며 AI 도움을 받는 방식 (이번 주엔 안 씀) | — |
4층 · 노코드 빌더 | 코드 화면을 아예 안 보고 문장으로 앱을 통째로 생성 (이번 주엔 안 씀) | — |
5층 · 연결·자동화 | AI를 다른 서비스와 직접 연결 | MCP, GitHub Actions |
6층 · 저장·배포 | 만든 걸 실제 인터넷에 올림 | GitHub, Vercel |
초보로서 제일 도움됐던 인사이트 : 나는 지금 2층(Claude Code) + 6층(GitHub·Vercel) 두 층만 쓰고 있다. 4층(노코드 빌더)을 건너뛰고 바로 2층부터 시작한 셈인데, 처음엔 이게 맞는 선택인지 몰랐다. 알고 보니 4층은 빠르지만 나중에 손댈 수 없는 벽을 만나는 경우가 많아서, 처음부터 2층으로 시작한 게 오히려 유리한 선택이었다.
또 하나, “하네스”라는 개념도 유용했다 — AI가 일하는 환경(지침 파일·규칙) 전체를 미리 설계해두는 것을 말하는데, 1일차에 만든 학습메이트 “하루”의 OUL.md·USER.md·AGENTS.md·CLAUDE.md 네 파일이 바로 이 하네스였다. 같은 Claude Code를 쓰더라도 하네스를 어떻게 짜두느냐에 따라 결과물이 완전히 달라진다는 걸 이번 주 내내 체감했다.
전체 6개 층·지식관리 갈래까지 더 자세한 구조는 별도로 정리해뒀다.
스스로 돌아보며
처음 시작한 만큼, 코딩이나 개발을 하나도 모르는 사람인데도 자연어로 머릿속에 있던 생각을 클로드 코드로 “바이브 코딩”해서 눈에 보이는 결과물로 만들어가는 과정이 신기하고 재밌었다. 시간 가는 줄 모를 정도였다.
동시에, 생소한 용어와 절차와 개념들을 하나하나 이해하는 데 생각보다 시간이 많이 걸려서 진행이 지연되기도 했다. 다만 막힐 때마다 물어보면 쉽게 풀어서 설명해준 덕분에 여기까지 잘 해낼 수 있었다.
배운 것 / 재사용 자산
아이디어를 좁히는 연습 : “다 하고 싶다”는 메모를 “4주 안에 되는 크기”로 깎는 것 자체가 기술이다.
막힘의 대부분은 디테일 : 이번 주 막혔던 지점(파일명 오타, 권한 스코프)은 핵심 개념이 어려워서가 아니라 도구 사용법의 사소한 디테일이었다.
“느낌”엔 이유가 있다 : 두서없다는 감각은 코드 어딘가의 실제 원인을 찾는 신호로 받아들이면 된다.
재사용 프롬프트 2개 : 위에 인용한 “개념페이지 정리” 프롬프트와 “API → JSON → 화면” 프롬프트는 다음 지표를 추가할 때도 그대로 쓸 수 있다.
향후 계획
수립한 PRD와 단계별 세부계획을 하나씩 미션 클리어하면서, 머릿속으로 구현하던 것을 세부적으로 구체화해서 만들어볼 계획이다.
로그인하고 댓글을 남겨 주세요
코딩 0에서 일주일 만에 FRED API 데이터를 GitHub Actions로 자동 커밋까지 — 결과물의 층위가 인상적이에요.
특히 "느낌이 이상하다"는 감각을 코드에서 실제 원인(로드맵 분류 충돌)으로 추적해서 잡아낸 부분이 좋았어요. 그 감각을 신호로 받아들이는 게 익숙해지면 이후 작업이 훨씬 빨라질 거예요.
6층 AI 생태계 레이어 구조 정리도 초보 입장에서 직접 써보면서 만든 거라 설득력이 달랐어요. "같은 층끼리 경쟁, 다른 층끼리 협력" 한 문장으로 정리하신 거 잘 됐습니다.
2주차에 반도체 섹터 데이터가 실제로 쌓이는 게 기대되네요. 고롱고롱… 이런 1주차 기록이 나중에 제일 재밌는 회고가 될 거예요 🐈⬛



“커밋 = 게임의 세이브포인트”로 이해한 뒤 일부러 망가뜨렸다가 되돌려본 연습이 눈에 들어왔습니다. 처음부터 FRED API나 GitHub Actions까지 간 것도 대단하지만, 겁 없이 고치려면 먼저 되돌릴 수 있다는 감각이 있어야 하니까요. 생각을 결과물로 바꾼 한 주라기보다, 앞으로 계속 실험할 수 있는 안전장치를 하나씩 깔아둔 한 주처럼 읽혔습니다.