Skip to content

1장. AI와 함께 만든다는 것 — SDLC 한눈에 ​

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

한 줄 요약: 소프트웨어는 계획 → 만들기 → 리뷰 → 확인 → 배포 → 운영을 거쳐 세상에 나갑니다. 이 흐름을 SDLC라고 부릅니다. AI는 각 단계의 손이 되어 주지만, 무엇을 만들지 정하고 결과를 확인하는 일은 사람 몫입니다. 4단계는 이 나눔을 배웁니다.

이 장은 2026년 11월 1일에 확인한 GitHub 공식 문서와 Claude Code 공식 문서를 바탕으로 썼습니다. 3단계에서 Claude Code·Codex·Antigravity로 폴더를 다뤄 본 독자를 위한 단계입니다. 아직 3단계를 보지 않았다면 3단계 · Claude Code부터 보세요.

SDLC란 ​

SDLC(소프트웨어 개발 생애 주기, Software Development Life Cycle)는 처음 아이디어부터 실제로 돌아가는 소프트웨어까지 프로젝트가 거치는 단계를 말합니다.[1] GitHub은 이 과정을 여섯 단계로 나눕니다.

단계하는 일이 가이드
계획(Plan)할 일을 적고 추적하기3장
만들기(Create)코드를 쓰고 변경을 기록하기4장
리뷰(Review)변경을 제안하고 의견 받기6장
확인(Test)합치기 전에 자동으로 검사하기5장
배포(Deploy)사람들이 쓰도록 내보내기7장
운영(Operate)지켜보고 고쳐 나가기8·9장

출처: GitHub 공식 문서(이 가이드의 정리)[2]

표의 장 번호 순서가 조금 다릅니다. 이 가이드는 확인(5장)을 리뷰(6장)보다 먼저 다룹니다. 리뷰할 때 확인 결과를 함께 보기 위해서입니다.[3]

처음부터 모든 단계를 다 쓸 필요는 없습니다. GitHub도 많은 사람이 저장소 하나와 할 일 몇 개로 시작해서 프로젝트가 자라는 만큼 넓혀 간다고 말합니다.[4] 이 가이드도 작은 웹 페이지 하나로 여섯 단계를 한 바퀴 돌아 봅니다.

확인 퀴즈

GitHub이 말하는 SDLC에 대한 설명으로 맞는 것은 무엇일까요?

AI는 어떻게 일하나 ​

Claude Code는 맡은 일을 세 단계로 처리합니다. 맥락 모으기 → 행동하기 → 결과 확인하기입니다.[5] 파일을 찾아 읽고, 고치고, 테스트를 돌려 자기 일을 확인하는 것까지 이 순환 안에 들어 있습니다.

3단계에서 써 본 계획 모드도 여기서 다시 중요해집니다. 계획 모드에서는 Claude가 파일을 읽고 계획만 내놓고, 내가 승인하기 전에는 아무것도 고치지 않습니다.[6]

공식 모범 사례 문서는 일이 기대대로 안 풀리는 대표 원인으로 이런 것들을 꼽습니다.[7]

  • 내 머릿속과 다른 것을 만들었다. 저장소만 읽어서는 알 수 없는 정보가 빠졌기 때문입니다. → 3장 「기획과 명세」에서 다룹니다.
  • 다 했다고 했는데 덜 됐다. 스스로 확인할 방법이 없었기 때문입니다. → 5장 「확인과 테스트」에서 다룹니다.

두 경우는 사람이 정보와 확인 장치를 건네면 줄일 수 있습니다. 그래서 4단계는 코드를 짜는 법보다 AI에게 무엇을 건네고, 무엇을 돌려받아 확인할지를 배웁니다.

확인 퀴즈

공식 문서가 꼽는, AI가 다 했다고 했는데 덜 된 흔한 이유는 무엇일까요?

사람이 맡는 일 ​

AI가 손을 맡아도 사람이 꼭 맡아야 하는 일이 있습니다.

단계사람이 맡는 일
계획무엇을, 왜 만들지 정하기
만들기계획을 읽고 승인하기
확인증거(명령과 출력)를 보고 판단하기
리뷰합칠지 결정하기
배포공개해도 되는지 판단하고 누르기

출처: 이 가이드의 정리(근거는 각 장의 각주)

공식 문서도 제안된 코드와 명령이 안전한지 승인 전에 검토할 책임은 사용자에게 있다고 적습니다.[8] 또 배포처럼 바깥 시스템에 영향을 주는 행동은 Claude Code의 되감기(체크포인트)로 되돌릴 수 없습니다.[9] 체크포인트는 요청을 보낼 때마다 자동으로 남는 저장 지점입니다. 게임의 저장 지점처럼 Claude가 고친 내 컴퓨터의 파일은 대부분 그 시점으로 되돌릴 수 있습니다(셸 명령이나 다른 세션이 바꾼 파일은 빼고). 하지만 인터넷에 이미 공개한 것은 되돌아오지 않습니다. 그래서 바깥으로 나가는 행동일수록 사람이 확인하고 누릅니다.

확인 퀴즈

AI와 함께 만들 때 사람이 꼭 맡아야 하는 일로 이 가이드가 꼽은 것은 무엇일까요?

이 단계에서 만들 것 ​

4단계의 「직접 해 보기」는 장마다 이어지는 하나의 예제로 합니다. 3단계 정리도구가 만든 회의록의 할 일을 모아 보여 주는 웹 페이지, 이름하여 「모퉁이 카페 할 일 보드」입니다.

GitHub의 공식 입문 시리즈도 작은 웹사이트 하나를 끝까지 따라 만들며 계획하고, 코드를 쓰고, 변경을 리뷰하고, 실제 웹사이트로 배포합니다.[10] 이 가이드는 같은 순서를 따르되, AI 자리에 3단계에서 익힌 Claude Code를 씁니다.

표에 낯선 말이 몇 개 나옵니다. 지금은 뜻만 가볍게 알아 두세요. 해당 장에서 차근차근 다룹니다.

  • GitHub(깃허브): 프로젝트 파일과 변경 기록을 인터넷에 올려 두고 함께 일하는 서비스
  • 저장소(Repository): 프로젝트 파일과 변경 기록을 두는 곳. 프로젝트의 집입니다
  • PR(Pull Request, 풀 리퀘스트): "내가 바꾼 것을 합쳐 주세요" 하고 내미는 변경 제안
  • GitHub Pages(깃허브 페이지스): 저장소의 파일을 무료로 웹 페이지로 공개해 주는 기능
장할 일 보드에서 하는 일
2GitHub에 저장소를 만든다
3무엇을 보여 줄지 인터뷰받고 SPEC.md를 쓴다
4계획을 받고, 브랜치에서 첫 화면을 만든다
5할 일 수가 맞는지 확인 장치를 만든다
6PR을 만들고 리뷰받는다
7GitHub Pages로 공개한다
8다음 개선을 이슈로 적고 한 바퀴 더 돈다
9공개 전에 비밀값과 개인 정보를 점검한다

출처: 이 가이드의 계획

처음부터 완벽할 필요는 없습니다. 한 장씩 따라가면 마지막에는 인터넷 주소가 붙은 내 페이지가 생깁니다.

정리 ​

  • SDLC는 아이디어부터 실제로 돌아가는 소프트웨어까지의 단계다. GitHub은 계획·만들기·리뷰·확인·배포·운영 여섯 단계로 나눈다.
  • 처음부터 다 쓸 필요는 없다. 작게 시작해 넓힌다.
  • Claude Code는 맥락 모으기 → 행동 → 결과 확인으로 일한다. 실패의 흔한 원인은 빠진 정보와 확인 장치의 부재다.
  • 무엇을 만들지 정하고, 증거를 보고 판단하고, 합치고 배포할지 정하는 일은 사람 몫이다.

용어 정리 ​

용어읽는 법한 줄 뜻
SDLC에스디엘씨소프트웨어가 아이디어에서 운영까지 거치는 단계
Repository리포지토리프로젝트 파일과 변경 기록을 두는 곳(저장소)
Deploy디플로이만든 것을 사람들이 쓰도록 내보내기(배포)
Plan mode플랜 모드고치기 전에 계획만 보여 주는 Claude Code의 방식

이 장을 다 읽었나요?

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

다음 장: 2장. GitHub 저장소 만들기

참고 자료 (10개)
  1. GitHub 공식 문서, 「What is GitHub?」. "The software development life cycle describes the stages a software project moves through, from the first idea to running code in production." docs.github.com (확인일 2026-11-01) ↩︎

  2. GitHub 공식 문서, 「What is GitHub?」. "Track your work, set milestones, and organize long-term projects." / "Write and store code, develop new features safely, and create a clear timeline of your changes." / "Suggest changes to your project, discuss your updates with reviewers, and apply feedback." / "Automate checks to validate every change before it merges." / "Ship software with automated deployment workflows and release management." / "Monitor applications, manage dependencies, and find and fix security issues." docs.github.com (확인일 2026-11-01) ↩︎

  3. 「운영」은 GitHub에서 감시·부품 관리·보안까지 넓은 뜻입니다. 이 가이드는 이슈로 개선하기(8장)와 안전(9장)까지만 다룹니다. ↩︎

  4. GitHub 공식 문서, 「What is GitHub?」. "You do not need to use every stage at once. Many people start with a repository and a few issues, then expand their use of the platform as their project grows." docs.github.com (확인일 2026-11-01) ↩︎

  5. Claude Code 공식 문서, 「How Claude Code works」. "When you give Claude a task, it works through three phases: gather context, take action, and verify results." code.claude.com (확인일 2026-11-01) ↩︎

  6. Claude Code 공식 문서, 「Common workflows」. "For changes you want to review before they touch disk, switch to plan mode. Claude reads files and proposes a plan but makes no edits until you approve." code.claude.com (확인일 2026-11-01) ↩︎

  7. Claude Code 공식 문서, 「Best practices for Claude Code」. "It's missing information it can't get from reading the repo." / "Claude said it was done and it wasn't quite, usually because it had no way to check its own work." code.claude.com (확인일 2026-11-01) ↩︎

  8. Claude Code 공식 문서, 「Security」. "You're responsible for reviewing proposed code and commands for safety before approval." code.claude.com (확인일 2026-11-01) ↩︎

  9. Claude Code 공식 문서, 「How Claude Code works」. "Actions that affect remote systems (databases, APIs, deployments) can't be checkpointed." code.claude.com (확인일 2026-11-01) ↩︎

  10. GitHub 공식 문서, 「Creating a repository for your project on GitHub」. "By the end of the journey, you'll plan work, write code, review changes, and deploy your code to a live website." docs.github.com (확인일 2026-11-01) ↩︎