Skip to content

10장. 실습 과제 — 처음부터 끝까지 한 바퀴 ​

필수 이 단계를 따라가려면 꼭 읽으세요.

한 줄 요약: 1~9장의 흐름을 한 번에 이어서 해 봅니다. 계획 → 만들기 → 확인 → 리뷰 → 배포 → 운영 → 안전 점검입니다. 마지막 과제는 내 문제로 처음부터 만드는 것입니다. 점검표로 스스로 확인하세요.

이 장은 앞 장들의 내용을 모은 과제 장입니다. 근거는 각 장의 각주에 있습니다. 처음부터 완벽할 필요는 없습니다. 막히면 그 장으로 돌아가 다시 읽으세요.

과제 1 — 할 일 보드 한 바퀴 ​

앞 장의 「직접 해 보기」를 따라왔다면 이미 끝난 과제입니다. 건너뛰었다면 순서대로 해 보세요.

순서할 일장
1GitHub에 공개 저장소 cafe-todo-board를 만들고 내 컴퓨터로 복제2
2Claude에게 인터뷰받아 SPEC.md 쓰기3
3새 세션·계획 모드로 계획을 받고, 브랜치에서 첫 화면 만들기4
4SPEC.md의 기준을 검사하는 장치를 만들고 증거 받기5
5PR을 만들고 SPEC.md와 대조한 리뷰 후 합치기6
6공개 전 점검표로 비밀값·개인 정보 확인9
7GitHub Pages로 공개하고 휴대폰에서 열기7
8개선을 이슈로 적고 fixes #이슈번호로 한 바퀴 더8

출처: 이 가이드의 정리

완성한 모습이 궁금하면 이 과제를 실제로 따라 만든 예시 페이지와 저장소를 보세요. 내 결과와 모양이 달라도 괜찮습니다.

확인 퀴즈

할 일 보드 한 바퀴의 순서로 맞는 것은 무엇일까요?

과제 2 — 내 문제로 처음부터 ​

내 생활이나 일에서 작은 불편 하나를 골라, 같은 흐름으로 웹 페이지를 만들어 보세요. 예를 들면 이런 것들입니다.

  • 우리 동아리 이번 달 일정 보기
  • 내가 읽은 책과 한 줄 감상 목록
  • 가게 메뉴와 영업시간 안내

처음 요청은 3장처럼 인터뷰로 시작합니다.

<내 불편>을 해결하는 작은 웹 페이지를 만들고 싶어. 아직 깊이 생각해 보지 않았어. 스펙을 쓸 수 있을 때까지 나를 인터뷰하고, 다 되면 SPEC.md에 써 줘. 공개 저장소에 올릴 거라 개인 정보는 넣지 않을 거야.

주의: 가게 안내처럼 실제 사업에 쓰려면, 7장에서 본 GitHub Pages의 금지 사항(사업·쇼핑몰·상업 서비스 운영)을 먼저 확인하세요. 연습으로 만드는 것과 실제 영업에 쓰는 것은 다릅니다.

확인 퀴즈

내 문제로 만든 가게 안내 페이지를 실제 영업에 쓰려고 합니다. 먼저 확인할 것은 무엇일까요?

점검표 ​

과제를 마치면 아래를 하나씩 확인하세요. 모두 "예"면 한 바퀴를 제대로 돈 것입니다.

계획

  • ☐ SPEC.md의 줄마다 예/아니오로 확인할 수 있다.
  • ☐ SPEC.md에 "하지 않을 것"이 한 줄 이상 있다.

만들기

  • ☐ 계획 모드로 계획을 읽고 승인한 뒤에 만들었다.
  • ☐ main이 아니라 브랜치에서 만들었고, 커밋 하나에 변경 하나다.

확인

  • ☐ 확인 장치가 있고, 실행한 명령과 출력이라는 증거를 받았다.
  • ☐ 일부러 틀리게 했을 때 검사가 실패하는 것을 봤다.

리뷰

  • ☐ PR 설명에 무엇을 왜 바꿨는지 적었다.
  • ☐ 새 세션에서 SPEC.md와 대조한 리뷰를 받았다. 발견이 없어도 직접 훑었다.

배포·운영

  • ☐ 공개 주소가 휴대폰에서도 열린다.
  • ☐ 다음 개선이 이슈로 적혀 있다.

안전

  • ☐ 저장소와 페이지에 비밀값·실명·연락처가 없다.
  • ☐ .gitignore가 있고, 비밀값이 들 만한 파일이 적혀 있다.

출처: 이 가이드의 정리

다른 도구로 해 보기 ​

이 절은 선택입니다. 3단계에서 Claude Code만 썼다면 건너뛰어도 됩니다.

3단계에는 Claude Code 말고도 Codex(OpenAI의 코딩 도구)와 Antigravity(Google의 코딩 도구) 가이드가 있습니다. 이 두 도구에도 대응하는 기능이 있어 같은 흐름을 따라갈 수 있습니다. 표의 이름은 각 도구에서 그 일을 하는 명령·화면·파일입니다.

하는 일CodexAntigravity
계획 먼저/planPlanning mode
바뀐 내용 보기리뷰 창Review 창
규칙 파일AGENTS.mdAGENTS.md·GEMINI.md

출처: Codex 4장·Antigravity 2·3장

같은 SPEC.md를 두 도구에 주고 결과를 비교해 보는 것도 좋은 연습입니다. 3단계에서 본 것처럼, 같은 지침이어도 도구마다 빠뜨리는 것이 다를 수 있습니다.

정리 ​

  • 과제 1은 할 일 보드로 계획부터 안전 점검까지 한 바퀴를 돈다.
  • 과제 2는 내 작은 불편으로 처음부터 만든다. 실제 사업에 쓰기 전에는 Pages 금지 사항을 확인한다.
  • 점검표의 모든 칸이 "예"면 한 바퀴를 제대로 돈 것이다.

이 장을 다 읽었나요?

기록은 이 브라우저에만 저장됩니다. 진행 현황은 전체 목차에서 볼 수 있어요.

다음 장: 4단계 AI-SDLC 가이드를 마쳤습니다. 이것으로 hello-ai의 1~4단계를 모두 마쳤습니다. 4단계 · AI-SDLC 목차에서 다시 보고 싶은 장을 고르거나, AI 지식 레벨 시험으로 지금까지 배운 것을 확인해 보세요.