10장. 실습 과제 — 처음부터 끝까지 한 바퀴
필수 이 단계를 따라가려면 꼭 읽으세요.한 줄 요약: 1~9장의 흐름을 한 번에 이어서 해 봅니다. 계획 → 만들기 → 확인 → 리뷰 → 배포 → 운영 → 안전 점검입니다. 마지막 과제는 내 문제로 처음부터 만드는 것입니다. 점검표로 스스로 확인하세요.
이 장은 앞 장들의 내용을 모은 과제 장입니다. 근거는 각 장의 각주에 있습니다. 처음부터 완벽할 필요는 없습니다. 막히면 그 장으로 돌아가 다시 읽으세요.
과제 1 — 할 일 보드 한 바퀴
앞 장의 「직접 해 보기」를 따라왔다면 이미 끝난 과제입니다. 건너뛰었다면 순서대로 해 보세요.
| 순서 | 할 일 | 장 |
|---|---|---|
| 1 | GitHub에 공개 저장소 cafe-todo-board를 만들고 내 컴퓨터로 복제 | 2 |
| 2 | Claude에게 인터뷰받아 SPEC.md 쓰기 | 3 |
| 3 | 새 세션·계획 모드로 계획을 받고, 브랜치에서 첫 화면 만들기 | 4 |
| 4 | SPEC.md의 기준을 검사하는 장치를 만들고 증거 받기 | 5 |
| 5 | PR을 만들고 SPEC.md와 대조한 리뷰 후 합치기 | 6 |
| 6 | 공개 전 점검표로 비밀값·개인 정보 확인 | 9 |
| 7 | GitHub 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의 코딩 도구) 가이드가 있습니다. 이 두 도구에도 대응하는 기능이 있어 같은 흐름을 따라갈 수 있습니다. 표의 이름은 각 도구에서 그 일을 하는 명령·화면·파일입니다.
| 하는 일 | Codex | Antigravity |
|---|---|---|
| 계획 먼저 | /plan | Planning mode |
| 바뀐 내용 보기 | 리뷰 창 | Review 창 |
| 규칙 파일 | AGENTS.md | AGENTS.md·GEMINI.md |
같은 SPEC.md를 두 도구에 주고 결과를 비교해 보는 것도 좋은 연습입니다. 3단계에서 본 것처럼, 같은 지침이어도 도구마다 빠뜨리는 것이 다를 수 있습니다.
정리
- 과제 1은 할 일 보드로 계획부터 안전 점검까지 한 바퀴를 돈다.
- 과제 2는 내 작은 불편으로 처음부터 만든다. 실제 사업에 쓰기 전에는 Pages 금지 사항을 확인한다.
- 점검표의 모든 칸이 "예"면 한 바퀴를 제대로 돈 것이다.
이 장을 다 읽었나요?
기록은 이 브라우저에만 저장됩니다. 진행 현황은 전체 목차에서 볼 수 있어요.
다음 장: 4단계 AI-SDLC 가이드를 마쳤습니다. 이것으로 hello-ai의 1~4단계를 모두 마쳤습니다. 4단계 · AI-SDLC 목차에서 다시 보고 싶은 장을 고르거나, AI 지식 레벨 시험으로 지금까지 배운 것을 확인해 보세요.