docs: localize Korean workshop content and sidebar

docs/ko-kr/README.md

@@ -40,4 +40,4 @@ GitHub Copilot CLI, GitHub Copilot 앱, GitHub Copilot 클라우드 에이전트
 [first-steps-app]: first-steps/copilot-app/
 [first-steps-cli]: first-steps/copilot-cli/
 [first-steps-vscode]: first-steps/vscode/
-[real-world-development]: ../real-world-development/
+[real-world-development]: real-world-development/

docs/ko-kr/first-steps/copilot-app/12-deploy-pages.md

@@ -0,0 +1,48 @@
+---
+title: "레슨 12 - GitHub Pages로 사이트 배포하기"
+description: "GitHub Copilot app을 사용해 Pages 워크플로를 구성하고, 풀 리퀘스트를 검토한 뒤, 게시된 Space Quiz를 확인합니다."
+authors:
+  - jamesmontemagno
+lastUpdated: 2026-10-12
+---
+
+Space Quiz를 GitHub Pages에 배포하여 공개적으로 이용할 수 있도록 합니다. Copilot은 워크플로를 준비하고 배포 과정을 안내할 수 있지만, 변경 사항을 검토하고 사이트가 게시되었는지 확인하는 책임은 사용자에게 있습니다.
+
+이 레슨에서는 다음을 수행합니다.
+
+- Copilot에 GitHub Pages 배포 구성을 요청합니다.
+- 병합하기 전에 워크플로와 풀 리퀘스트를 검토합니다.
+- 배포 과정을 따라가고 게시된 사이트를 확인합니다.
+
+## 시나리오
+
+Space Quiz는 이미 GitHub 리포지토리에 있지만, 누구나 간단히 이용할 수 있는 방법은 아직 없습니다. 서버나 런타임 종속성을 추가하지 않고 GitHub Pages로 단일 파일 사이트를 게시하면 공개 URL에서 이용할 수 있습니다.
+
+## Copilot에 사이트 배포 요청하기
+
+`space-quiz`의 Copilot app 세션에서 다음 프롬프트를 보냅니다.
+
+```plaintext
+이 리포지토리에서 GitHub Pages를 활성화해 주세요. 필요한 경우 웹사이트를 빌드하고 GitHub Pages에 배포하는 GitHub Actions 워크플로를 만들어 주세요. 아직 README가 없다면 앱 소개와 로컬 실행 방법을 설명하는 README를 추가해 주세요. 변경 사항으로 풀 리퀘스트를 만들고 필수 검사가 통과하면 병합해 주세요. 배포가 성공할 때까지 모니터링한 다음 실제 웹사이트의 최종 URL을 알려 주세요. Pages를 활성화하거나 병합할 권한이 없다면 제가 무엇을 승인하거나 해야 하는지 정확히 알려 주세요. 사이트가 실제로 게시되기 전까지 성공했다고 보고하지 마세요.
+```
+
+![Space Quiz 풀 리퀘스트 병합, Build website·Upload artifact·Deploy to Pages 단계가 성공한 GitHub Actions 배포 실행, yourname.github.io/space-quiz/에서 열린 Space Quiz를 보여 주는 3단계 다이어그램](../../../_images/first-steps-app-pages-deploy.svg)
+
+> [!WARNING]
+> 이 프롬프트는 에이전트에 풀 리퀘스트 생성 및 병합과 리포지토리의 Pages 설정 변경을 요청합니다. 진행하기 전에 diff, 배포 권한, GitHub의 승인 요청을 검토합니다.
+
+## 워크플로 검토 및 배포 확인하기
+
+1. 리포지토리에 README가 없는 경우에만 추가되었는지 확인합니다.
+2. 워크플로의 빌드 및 배포 단계를 포함해 풀 리퀘스트 변경 사항을 검토합니다.
+3. 필수 풀 리퀘스트 검사가 통과한 뒤에만 병합합니다.
+4. GitHub Actions 배포 실행이 성공할 때까지 확인합니다.
+5. 보고된 URL을 열어 Space Quiz가 로드되는지 확인합니다.
+
+에이전트가 Pages를 활성화하거나 풀 리퀘스트를 병합할 수 없다면 제공된 구체적인 지침을 따릅니다. 배포가 성공하고 실제 사이트가 로드될 때까지 작업이 완료된 것으로 처리하지 않습니다.
+
+## 요약 및 다음 단계
+
+Space Quiz를 실제 사이트로 게시하고 에이전트의 보고에 의존하지 않고 배포를 확인했습니다. 다음으로 [레슨 13: 검토 및 다음 단계][next-lesson]를 진행합니다.
+
+[next-lesson]: ../13-review/

docs/ko-kr/real-world-development/README.md

@@ -0,0 +1,38 @@
+---
+title: "실제 개발"
+slug: ko-kr/real-world-development
+authors:
+  - geektrainer
+lastUpdated: 2026-09-16
+---
+
+현실적인 시나리오와 완성된 애플리케이션, 공유 백로그를 바탕으로 소프트웨어 개발 수명 주기 전반에서 GitHub Copilot을 살펴봅니다. 반복적으로 변경을 계획하고 코드를 작성하고 동작을 테스트하며 풀 리퀘스트를 검토하고 에이전트로 작업을 관리합니다.
+
+## 시나리오
+
+개발자 테마의 보드게임 크라우드 펀딩을 제공하는 가상의 회사 Tailspin Toys에서 새 개발자로 일한다고 가정합니다. 팀의 백로그는 GitHub 이슈로 등록되어 있어 바로 작업을 시작할 수 있습니다. 백로그에는 필터링 및 페이지 매김과 같은 기능 작업과 접근성 및 코딩 표준과 같은 품질 개선 작업이 포함되어 있습니다.
+
+## 작업 환경 선택하기
+
+GitHub Copilot은 다양한 작업 환경에서 사용할 수 있습니다. 원하는 개발 방식에 맞는 환경을 선택합니다. 각 워크숍은 자체 설정 절차로 시작하며 동일한 Tailspin Toys 시나리오를 사용합니다.
+
+### [GitHub Copilot CLI][cli]
+
+터미널에서 에이전트형 도우미를 사용합니다. Plan 및 Autopilot 모드, 지침, 스킬, 사용자 지정 에이전트, Playwright MCP, Agent Merge, 실용적인 슬래시 명령을 살펴봅니다.
+
+### [GitHub Copilot app][app]
+
+병렬 에이전트 세션을 실행하고 세션 모드를 전환하며 캔버스에서 협업하고 데스크톱 앱에서 GitHub 이슈와 풀 리퀘스트를 관리합니다.
+
+### [GitHub Copilot cloud agent][cloud]
+
+GitHub 이슈를 비동기 에이전트에 할당하고 작업을 안내하며 진행 상황을 모니터링하고 에이전트가 여는 풀 리퀘스트를 검토합니다.
+
+### [Visual Studio Code][vscode]
+
+Visual Studio Code와 GitHub Codespaces에서 GitHub Copilot을 사용합니다. 편집기를 벗어나지 않고 Copilot Chat 에이전트 모드, MCP 서버, 사용자 지정 에이전트를 활용합니다.
+
+[cli]: cli/
+[app]: app/
+[cloud]: cloud/
+[vscode]: vscode/

docs/ko-kr/real-world-development/cli/0-prerequisites.md

@@ -1,71 +1,66 @@
 ---
-title: "연습 0: 사전 준비"
+title: "레슨 0 - 사전 준비"
+description: "Tailspin Toys의 복사본을 만들고 Copilot CLI 워크숍에 사용할 GitHub Codespace를 준비합니다."
 authors:
   - geektrainer
-lastUpdated: 2026-06-30
+lastUpdated: 2026-09-18
 ---
 
-Copilot CLI 연습을 시작하기 전에 모든 것을 준비해야 합니다. Tailspin Toys 리포지토리(Repository)의 복사본을 만들고 [코드스페이스][codespaces]를 시작합니다. 다음 연습에서는 해당 코드스페이스의 통합 터미널을 사용해 Copilot CLI를 설치하고 실행합니다.
+Copilot CLI 레슨을 시작하기 전에 필요한 사항을 준비합니다. Tailspin Toys 리포지토리의 복사본을 만들고 [Codespace][codespaces]를 시작합니다. 다음 레슨에서는 통합 터미널을 사용해 Copilot CLI를 설치하고 실행합니다.
 
-## 실습용 리포지토리 설정
+이 레슨에서는 다음을 수행합니다.
 
-앞으로 작성할 코드를 위한 리포지토리 복사본을 만들기 위해 [template][template-repository]에서 새 인스턴스(Instance)를 만듭니다. 새 인스턴스에는 실습에 필요한 파일이 모두 포함되며, 연습을 진행하는 동안 이 리포지토리를 사용합니다.
+- 템플릿에서 Tailspin Toys 프로젝트의 복사본을 만듭니다.
+- Codespace를 만들고 프로젝트가 준비되었는지 확인합니다.
 
-1. 새 브라우저 창에서 이 실습의 GitHub 리포지토리로 이동합니다: `https://github.com/github-samples/tailspin-toys`.
-2. 실습용 리포지토리 페이지에서 **Use this template** 버튼을 선택해 리포지토리 복사본을 만듭니다. 그런 다음 **Create a new repository**를 선택합니다.
+## 실습용 리포지토리 설정하기
 
-    ![Use this template 버튼](../../../_images/ex0-use-template.png)
+Tailspin Toys 프로젝트의 복사본을 사용해 작업합니다. 지금 [템플릿 리포지토리][tailspin-template]에서 복사본을 만듭니다. 새 리포지토리에는 실습에 필요한 파일이 모두 포함되어 있습니다.
 
-3. GitHub 또는 Microsoft가 진행하는 행사에서 이 워크숍을 수행하는 경우에는 멘토가 제공하는 안내를 따릅니다. 그렇지 않다면 GitHub Copilot에 액세스할 수 있는 조직에 새 리포지토리를 만들어도 됩니다.
-
-    ![리포지토리 템플릿 설정 입력 화면](../../../_images/ex0-repository-settings.png)
-
-4. 이후 실습에서 참조할 수 있도록 생성한 리포지토리 경로(**organization-or-user-name/repository-name**)를 기록해 둡니다.
+1. 새 브라우저 창에서 [Tailspin Toys 템플릿][tailspin-template]으로 이동합니다.
+2. **Use this template**를 선택한 다음 **Create a new repository**를 선택하여 리포지토리 복사본을 만듭니다.
+3. GitHub 또는 Microsoft가 진행하는 행사에서 워크숍을 수행하는 경우 멘토의 안내를 따릅니다. 그렇지 않다면 GitHub Copilot을 사용할 수 있는 조직에 새 리포지토리를 만듭니다.
+4. 나중에 참조할 수 있도록 생성한 리포지토리 경로(`organization-or-user-name/repository-name`)를 기록해 둡니다.
 
 > [!NOTE]
-> **백로그가 준비되었습니다**
->
-> template에서 리포지토리를 만들면 GitHub issue 백로그가 자동으로 생성됩니다. 워크숍 내내 이 issue를 바탕으로 작업하므로 직접 등록할 내용은 없습니다.
-
-## 코드스페이스 만들기
+> 템플릿에서 리포지토리를 만들면 GitHub 이슈 백로그가 자동으로 생성됩니다. 워크숍 전체에서 해당 이슈를 사용하므로 직접 등록할 필요가 없습니다.
 
-이제 코드스페이스를 사용해 실습을 진행합니다.
-
-[GitHub Codespaces][codespaces]는 브라우저에서 직접 코드를 작성하고, 실행하고, 디버그할 수 있는 클라우드 기반 개발 환경입니다. 여러 프로그래밍 언어, 확장, 도구를 지원하는 완전한 기능의 IDE를 제공합니다.
-
-1. 방금 만든 리포지토리로 이동합니다.
-2. 초록색 **Code** 버튼을 선택합니다.
+새 워크숍 템플릿 복사본을 사용합니다. 여기에는 리포지토리 지침, 애플리케이션 코드, 테스트, `quality-checks` 스킬, 실습에 사용할 백로그가 포함되어 있습니다. 이전 복사본을 사용한다면 필요한 파일이 있는지 진행자에게 확인합니다.
 
-    ![Code 버튼 선택 화면](../../../_images/ex0-code-button.png)
+## Codespace 만들기
 
-3. **Codespaces** 탭을 선택한 다음 **+** 버튼을 선택해 새 Codespace를 만듭니다.
+이제 Codespace에서 워크숍을 진행합니다.
 
-    ![새 codespace 만들기](../../../_images/ex0-create-codespace.png)
+[GitHub Codespaces][codespaces]는 브라우저에서 코드를 작성하고 실행하고 디버그할 수 있는 클라우드 기반 개발 환경입니다. 여러 프로그래밍 언어, 확장, 도구를 지원하는 완전한 기능의 편집기를 제공합니다.
 
-코드스페이스를 만드는 데는 몇 분 정도 걸리지만, 모든 서비스를 수동으로 설치하는 것보다 훨씬 빠릅니다. 기다리는 동안에는 GitHub Copilot의 다른 기능을 살펴볼 수 있으며, 다음 단계에서 그 부분을 이어서 알아봅니다.
+1. 방금 만든 리포지토리로 이동합니다.
+2. **Code**를 선택합니다.
+3. **Codespaces** 탭을 선택한 다음 **Create codespace on main**을 선택합니다.
+4. Codespace 설정이 완료될 때까지 기다립니다. 템플릿에서 프로젝트 종속성, Playwright Chromium, 로컬 데이터베이스를 설치합니다.
+5. **Do you trust the authors of the files in this folder?**라는 메시지가 표시되면 **Trust Folder & Continue**를 선택합니다.
+6. 리포지토리 루트에서 터미널을 열고 애플리케이션을 시작합니다.
 
-> [!CAUTION]
-> 이후 연습에서 다시 코드스페이스로 돌아옵니다. 지금은 브라우저 탭에서 그대로 열어 둡니다.
+   ```bash
+   npm run dev
+   ```
 
-> [!NOTE]
-> 이 워크숍은 코드스페이스 또는 로컬 [dev container][dev-containers] 안에서 실행하도록 설계되었습니다. 두 환경 모두 원활한 진행에 필요한 사전 요구 사항이 모두 설치된 상태를 보장합니다. 로컬에서 실행하고 싶다면 복제한 리포지토리를 VS Code에서 열고, 메시지가 표시되면 **Reopen in Container**를 선택합니다. 그러면 코드스페이스에서 사용하는 것과 동일한 dev container를 VS Code가 빌드합니다.
+7. Codespaces에서 포트 `4321`을 사용할 수 있다고 표시되면 **Open in Browser**를 선택하고 Tailspin Toys 사이트가 로드되는지 확인합니다.
+8. 터미널로 돌아가 <kbd>Ctrl</kbd>+<kbd>C</kbd>를 눌러 개발 서버를 중지합니다.
 
-[codespaces]: https://github.com/features/codespaces
-[dev-containers]: https://code.visualstudio.com/docs/devcontainers/containers
-## 요약
+## 요약 및 다음 단계
 
-축하합니다! 실습용 리포지토리 복사본을 만들었습니다. 또한 Copilot CLI 작업을 시작할 때 사용할 코드스페이스 생성도 시작했습니다.
+준비가 끝났습니다. 이 레슨에서는 템플릿에서 Tailspin Toys 프로젝트의 복사본을 만들고 Codespace를 준비했습니다.
 
-## 다음 단계
-
-Copilot CLI를 설치하고 GitHub 계정으로 인증해 보겠습니다. [연습 1 - GitHub Copilot CLI 설치][next-lesson]로 계속 진행합니다.
+다음으로 Codespace에 [GitHub Copilot CLI를 설치][next-lesson]하고 GitHub 계정으로 인증합니다.
 
 ## 리소스
 
 - [GitHub Codespaces 개요][codespaces]
 - [템플릿에서 리포지토리 만들기][template-repository]
-- [Codespaces 빠른 시작][codespaces-quickstart]
+- [Codespaces 시작하기][codespaces-quickstart]
 
+[tailspin-template]: https://github.com/github-samples/tailspin-toys
 [template-repository]: https://docs.github.com/repositories/creating-and-managing-repositories/creating-a-template-repository
 [codespaces-quickstart]: https://docs.github.com/codespaces/getting-started/quickstart
 [next-lesson]: ../1-install-copilot-cli/
+[codespaces]: https://github.com/features/codespaces