4단계 · AI-SDLC 가이드
SDLC(소프트웨어 개발 생애 주기)는 아이디어가 실제로 돌아가는 소프트웨어가 되기까지 거치는 단계입니다. 4단계에서는 3단계에서 익힌 AI 도구와 함께 작은 웹 페이지 하나를 기획부터 배포·개선까지 만들어 봅니다. 코드를 몰라도 괜찮습니다. 이 단계에서 배우는 것은 코드 짜는 법이 아니라 AI에게 무엇을 건네고, 무엇을 돌려받아 확인하는가입니다.
이 가이드는 2026년 11월 1일에 확인한 GitHub·Claude Code 공식 문서와 spec-kit·OpenSpec 저장소의 설명을 바탕으로 썼습니다. 기능과 화면 이름은 자주 바뀝니다. GitHub 무료 계정이면 됩니다. AI 도구는 3단계에서 쓴 것(Claude Code·Codex·Antigravity)을 그대로 씁니다.
| 장 | 읽기 | 제목 | 이런 걸 알게 됩니다 |
|---|---|---|---|
| 1 | 필수 | AI와 함께 만든다는 것 | SDLC 여섯 단계, AI의 일하는 순환, 사람이 맡을 일 |
| 2 | 필수 | GitHub 저장소 만들기 | Git·GitHub·저장소, 공개와 비공개, README·.gitignore·라이선스, 복제 |
| 3 | 필수 | 기획과 명세 | 인터뷰받고 SPEC.md, 좋은 명세의 모양, 스펙 주도 개발 도구 |
| 4 | 필수 | 만들기 | 계획 모드, 브랜치, 작은 커밋, AI가 만든 것 읽기 |
| 5 | 필수 | 확인과 테스트 | 확인 장치, 증거 받기, GitHub Actions |
| 6 | 필수 | PR과 리뷰 | PR, 혼자여도 리뷰, /code-review의 한계, 합치기 |
| 7 | 필수 | 배포 | GitHub Pages, 게시 방법, 한도와 금지 사항, 되돌릴 수 없는 배포 |
| 8 | 필수 | 운영과 개선 | 이슈·라벨·보드, fixes 키워드, 한 바퀴 더 |
| 9 | 필수 | 안전과 책임 | 비밀값 세 겹 방어, 공개 점검, 라이선스·AI 출력물, 의존성 |
| 10 | 필수 | 실습 과제 | 할 일 보드 한 바퀴, 내 문제로 처음부터, 점검표 |
이어지는 예제 — 모퉁이 카페 할 일 보드
장마다 끝의 「직접 해 보기」는 하나의 예제로 이어집니다. 3단계 정리도구가 만든 회의록의 할 일을 모아 보여 주는 웹 페이지입니다. 할 일 데이터는 3단계 결과물을 씁니다.
메모 속 이름(민지·준호·서연)은 모두 지어낸 것입니다. 내 메모로 바꿔 쓴다면, 공개 저장소에 올리기 전에 실명과 연락처를 지우세요(9장).
이 가이드의 실습을 실제로 따라 만든 할 일 보드는 예시 페이지와 저장소에서 볼 수 있습니다. 내 결과와 모양이 달라도 괜찮습니다.
3단계를 아직 보지 않았다면 3단계 · Claude Code부터 보세요. 폴더·권한·규칙 파일·계획 모드는 거기서 설명하고, 이 단계는 링크로 이어 줍니다.