Skip to content

8장. 운영과 개선 — 이슈로 다음 바퀴 돌기 ​

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

한 줄 요약: 공개한 뒤에 떠오른 개선점과 버그는 이슈(Issue)로 적어 둡니다. 이슈 하나가 다음 바퀴의 기획이 됩니다. PR에 fixes #번호처럼 정해진 단어를 쓰면, PR을 합칠 때 그 이슈가 자동으로 닫힙니다. 기획과 운영이 이렇게 이어집니다.

이 장은 2026년 11월 1일에 확인한 GitHub 공식 문서를 바탕으로 썼습니다. GitHub 화면은 영어 기준으로 적었습니다.

이슈란 ​

이슈는 계획하고, 논의하고, 할 일을 추적하는 기록입니다.[1] 버그 신고, 새 기능, 아이디어처럼 적어 두거나 이야기할 것은 무엇이든 담습니다. 3단계의 회의록에 "다음에 논의할 것"을 적었던 것과 비슷합니다.

이슈는 PR과 이어집니다. 이슈나 PR에서 다른 이슈를 언급하면 서로 연결되고, PR에 fixes 같은 정해진 단어를 쓰면 관련 이슈가 자동으로 닫힙니다.[2]

fixes #이슈번호

이슈 번호는 이슈 제목 옆에 #2처럼 붙어 있습니다. 6장에서 PR을 하나 만들었다면 첫 이슈가 1번이 아닐 수 있으니, 꼭 화면에서 확인하세요.

이슈를 쓸 때는 제목에 만들 기능을 적고, 설명에 만들고 싶은 것을 몇 줄 적으면 됩니다.[3] 예를 들어 제목은 "기한 지난 할 일을 빨간색으로", 설명은 "기한이 오늘보다 앞선 할 일은 글자를 빨간색으로 보여 주면 좋겠다"처럼 씁니다.

확인 퀴즈

PR 설명에 fixes #1 이라고 쓰면 어떻게 될까요?

라벨과 보드로 정리하기 ​

이슈가 늘어나면 라벨로 나눕니다. 새 저장소에는 기본 라벨이 들어 있습니다.[4]

라벨뜻
bug예상치 못한 문제
enhancement새 기능 요청
documentation문서 개선

출처: GitHub 공식 문서(일부만 옮김)[4:1]

프로젝트(Projects)는 이슈·PR과 이어진 표·보드·로드맵입니다.[5] 튜토리얼의 보드는 열이 일의 단계를 나타냅니다. 할 일(Todo) → 진행 중(In Progress) → 완료(Done)로 옮기며 진행을 봅니다.[6]

처음부터 다 쓸 필요는 없습니다. 1장에서 본 것처럼, 많은 사람이 저장소 하나와 이슈 몇 개로 시작합니다. 라벨과 보드는 이슈가 늘어 한눈에 보기 어려워지면 써도 늦지 않습니다.

확인 퀴즈

새 기능 요청 이슈에 붙이기 알맞은 GitHub 기본 라벨은 무엇일까요?

한 바퀴 더 돌기 ​

한 바퀴가 끝나면, 다음 기능을 새 이슈로 만들어 다음 순환을 시작합니다. 보드를 쓴다면 일을 시작할 때 그 이슈를 진행 중(In Progress)으로 옮깁니다.[7] 보드가 없어도 이슈만으로 충분합니다.

앞의 3~7장에서 배운 흐름을 이슈 하나로 다시 돌면 이렇습니다.

  1. 계획: 이슈에 무엇을 바꿀지 적는다. 필요하면 SPEC.md에 확인 기준을 한 줄 더한다(3장).
  2. 만들기: 새 브랜치에서 계획 모드로 계획을 받고 만든다(4장).
  3. 확인: 확인 장치를 돌리고 증거를 받는다. 기존 검사도 모두 통과해야 한다(5장).
  4. 리뷰: PR에 fixes #번호를 적고 리뷰를 받는다(6장).
  5. 배포: 합치면 Pages에 다시 게시된다(7장).

Claude Code에게 이슈를 그대로 넘길 수도 있습니다.

GitHub 이슈 #<이슈 번호>의 내용을 읽고, SPEC.md에 확인 기준을 한 줄 더한 뒤 계획부터 세워 줘. 아직 파일은 고치지 마.

Claude가 이슈를 읽지 못한다고 하면, 이슈 제목과 내용을 복사해 요청에 붙여 넣으세요. 그 방법이 가장 확실합니다.

확인 퀴즈

이슈 하나로 다음 바퀴를 돌 때 확인 단계에서 꼭 챙길 것은 무엇일까요?

릴리스는 나중에 ​

릴리스(Release)는 더 많은 사람이 내려받아 쓸 수 있게 묶은 배포 단위입니다.[8] 내려받아 설치하는 프로그램에는 중요하지만, 웹 페이지 하나짜리 할 일 보드에는 꼭 필요하지 않습니다. 이런 것이 있다는 것만 알아 두세요.

직접 해 보기 ​

  1. cafe-todo-board 저장소 첫 화면에서 Issues → New issue로 새 이슈를 만든다.[9] 제목은 "기한 지난 할 일을 빨간색으로", 라벨은 enhancement.
  2. 이슈 내용을 Claude Code에 넘기고, SPEC.md에 확인 기준을 한 줄 더한 뒤 계획부터 받는다.
  3. 새 브랜치에서 만들고, 확인 장치로 새 기준과 기존 기준이 모두 통과하는지 증거를 받는다.
  4. 이슈 제목 옆의 번호를 확인하고, PR 설명에 fixes #이슈번호를 적는다. 리뷰한 뒤 합친다.
  5. 이슈가 자동으로 닫혔는지, Pages에 바뀐 화면이 나오는지 확인한다.

이어지는 과제: 9장에서는 공개 저장소에 비밀값과 개인 정보가 들어가지 않게 지키는 법을 정리합니다.

정리 ​

  • 이슈는 계획·논의·추적의 기록이다. 개선점과 버그를 이슈로 적어 다음 바퀴를 시작한다.
  • PR에 fixes #이슈번호를 쓰면 합칠 때 이슈가 자동으로 닫힌다. 번호는 화면에서 확인한다.
  • 라벨(bug·enhancement·documentation)과 보드(Todo → In Progress → Done)는 이슈가 늘면 쓴다.
  • 다음 바퀴도 계획 → 만들기 → 확인 → 리뷰 → 배포. 기존 검사도 계속 통과해야 한다.

용어 정리 ​

용어읽는 법한 줄 뜻
Issue이슈할 일·버그·아이디어를 적고 추적하는 기록
Label라벨이슈와 PR을 나누는 꼬리표
Project프로젝트이슈·PR과 이어진 표·보드·로드맵
Release릴리스내려받아 쓸 수 있게 묶은 배포 단위

이 장을 다 읽었나요?

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

다음 장: 9장. 안전과 책임

참고 자료 (9개)
  1. GitHub 공식 문서, 「About issues」. "You can create issues in your repository to plan, discuss, and track work." docs.github.com (확인일 2026-11-01) ↩︎

  2. GitHub 공식 문서, 「About issues」. "Mentioning an issue in another issue or pull request will create references between them and using keywords, like fixes:, in your pull requests will automatically close the associated issues." docs.github.com (확인일 2026-11-01) ↩︎

  3. GitHub의 입문 튜토리얼도 계획 단계에서 이렇게 첫 이슈를 만듭니다. GitHub 공식 문서, 「Planning your work」. "In the Add a title field, type Display a list of starred repositories." docs.github.com (확인일 2026-11-01) ↩︎

  4. GitHub 공식 문서, 「Managing labels」. "GitHub provides default labels in every new repository." / "bug | Indicates an unexpected problem or unintended behavior" / "documentation | Indicates a need for improvements or additions to documentation" / "enhancement | Indicates new feature requests" docs.github.com (확인일 2026-11-01) ↩︎

  5. GitHub 공식 문서, 「About Projects」. "A project is an adaptable table, board, and roadmap that integrates with your issues and pull requests on GitHub to help you plan and track your work effectively at the user or organization level." docs.github.com (확인일 2026-11-01) ↩︎

  6. GitHub 공식 문서, 「Planning your work」. "The board's columns represent stages of your work. As you make progress, move each item to show its status." docs.github.com (확인일 2026-11-01) ↩︎

  7. GitHub 공식 문서, 「Reviewing your proposed changes」. "If you have more features to build, create new issues and move them to In Progress when you start the next cycle." docs.github.com (확인일 2026-11-01) ↩︎

  8. GitHub 공식 문서, 「About releases」. "Releases are deployable software iterations you can package and make available for a wider audience to download and use." docs.github.com (확인일 2026-11-01) ↩︎

  9. GitHub 공식 문서, 「Planning your work」. "On the main page of your stargazers-log repository, click Issues." / "Click New issue." docs.github.com (확인일 2026-11-01) ↩︎