GitHub Copilot 코딩 에이전트와 함께 백로그를 정리하세요

Source: GitHub Blog

죄송합니다만, 번역하려는 본문 텍스트를 제공해 주시면 한국어로 번역해 드리겠습니다. 현재는 링크만 제공되어 있어 실제 내용이 없으므로 번역이 불가능합니다. 텍스트를 복사해서 보내 주시면 바로 번역해 드리겠습니다.

GitHub Copilot과 함께 WRAP 프레임워크 사용하기

GitHub의 엔지니어들은 GitHub Copilot coding agent를 1년 넘게 사용해오면서, 이 도구가 개발자들의 실제 시간과 에너지를 절약할 수 있음을 배우고 있습니다. 그 경험을 바탕으로 코딩 에이전트를 최대한 활용할 수 있도록 간단하고 기억하기 쉬운 약어를 정리했습니다:

WRAP

WRAP이 도움이 되는 이유

• 백로그 과부하: 긴 이슈 목록을 우선순위화하고 각 이슈를 Copilot이 처리할 수 있는 원자적 작업으로 전환합니다.
• 기술 부채 vs. 새로운 기능: 에이전트를 사용해 부채를 해결하면서 새로운 기능을 출시하는 데 집중합니다.
• 집중 분산: Copilot이 작은 버그나 실험을 처리하도록 하여, 여러분은 더 큰 전략적 작업에 집중할 수 있습니다.

빠른 예시

Issue: “사용자 목록 페이지에 페이지네이션 추가하기.”
WRAP 적용:

1. Write UI 목업과 API 계약을 포함한 간결한 이슈를 작성합니다.
2. Refine 지시사항: “page와 limit 쿼리 파라미터로 사용자를 가져오고, 페이지당 10명을 표시하며, Next/Prev 버튼을 포함하는 UserList 컴포넌트를 생성합니다.”
3. Atomic 작업: 별도의 usePagination 훅에 페이지네이션 로직을 구현합니다.
4. Pair: Copilot을 실행하고, 생성된 훅을 검토한 뒤, 엣지 케이스 처리를 조정하고 병합합니다.

WRAP을 따르면, 빠르게 작업에 익숙해지고 코딩 에이전트가 이전에 시간이 없어서 못 했던 작업을 처리하도록 할 수 있습니다. 즐거운 코딩 되세요!

효과적인 이슈 작성

WRAP의 첫 번째 단계는 GitHub Copilot 코딩 에이전트를 위해 효과적인 이슈를 작성하는 것입니다. 이슈를 새로운 팀원의 온보딩 자료로 생각하세요—충분한 컨텍스트를 제공하면 에이전트가 성공할 수 있는 기반이 마련됩니다.

가이드라인

• 신입 개발자를 위해 작성 – 작업을 이해하는 데 필요한 모든 배경 정보를 포함합니다. 이렇게 하면 코딩 에이전트에 필요한 컨텍스트가 자연스럽게 제공됩니다.
• 설명적인 제목 작성 – 제목에는 무엇을 어디에서 수행하는지가 명시되어야 합니다. 에이전트에 여러 작업을 할당할 수 있기 때문에, 명확한 제목은 이슈 패널을 쉽게 탐색할 수 있게 합니다.
• 구체적인 예시 추가 – 원하는 구현 방식(예: 특정 오류‑처리 패턴)을 이미 알고 있다면, 이슈에 짧은 예시를 붙여넣으세요. 이렇게 하면 원하는 정확한 결과를 얻을 가능성이 크게 높아집니다.

예시

다음과 같이 작성하지 말고:

Update the entire repository to use async/await

다음과 같이 작성:

인증 미들웨어를 아래 예시와 같이 최신 async/await 패턴을 사용하도록 업데이트합니다. 변경 사항을 검증하고 엣지 케이스를 다루는 단위 테스트를 추가하세요.

// Example async/await usage
async function exampleFunction() {
  const result = await promise;
  console.log(result); // "done!"
}

이 팁들을 따라 명확하고 실행 가능한 이슈를 만들어 코딩 에이전트가 고품질 코드를 빠르게 제공하도록 돕습니다.

지침 다듬기

다음 단계인 WRAP은 GitHub Copilot 맞춤 지침을 다듬어 코딩‑에이전트가 생성한 풀 리퀘스트 결과를 향상시키는 것입니다. 만들 수 있는 맞춤 지침에는 여러 종류가 있으며, 각각 다른 상황에 적합합니다.

저장소 맞춤 지침

전체 저장소에 적용되는 정보를 저장합니다.

예시: Go 애플리케이션을 사용하고 특정 코딩 스타일을 선호한다면, 여기에서 해당 가이드라인을 추가하세요. 시간이 지나면서 이 지침을 추가하고 업데이트하면 저장소 내 모든 Copilot 상호작용이 개선됩니다.

• 팁: 이는 GitHub Copilot 코딩 에이전트의 이상적인 첫 번째 사용 사례입니다. 에이전트에게 저장소 수준의 맞춤 지침을 생성하도록 요청하세요.
• 가이드: Add repository custom instructions

조직 맞춤 지침

조직 내 모든 저장소에 적용되는 지침 세트를 만듭니다.

예시: 모든 프로젝트에 걸쳐 보편적인 테스트 전략을 적용합니다.

• 가이드: Add organization custom instructions

코딩‑에이전트 맞춤 에이전트

재사용 가능한 에이전트를 정의합니다(자연어 텍스트 파일을 통해) — 기업, 조직, 또는 저장소 수준으로 범위를 지정할 수 있습니다. 이러한 에이전트는 모든 변경에 필요하지 않은 반복적인 개발 작업을 자동화합니다.

예시: 새로운 제품을 특정 저장소와 통합할 때 필요한 보일러플레이트를 처리하는 “통합 에이전트”.

• 가이드: Create custom agents

기억하세요: 맞춤 지침을 지속적으로 다듬고 확장하세요. 지침이 더 정확하고 포괄적일수록 Copilot 에이전트가 코드를 생성하고 풀 리퀘스트를 만들 때 더 좋은 성능을 발휘합니다.

Atomic Tasks

코딩 에이전트는 작고, 원자적이며 명확히 정의된 작업을 처리하는 데 뛰어납니다. 이러한 에이전트를 더 큰 문제에 활용하려면 문제를 여러 개의 독립적인 작은 작업으로 나누면 됩니다.

Why break tasks down?

• 단일 거대한 요청(예: “Java 코드를 300만 줄을 Go로 전체 재작성”)은 에이전트가 효율적으로 처리하기에 너무 광범위합니다.
• 큰 변경은 테스트, 검증, 리뷰가 어렵습니다.

Example: Migrating a Java codebase to Go

하나의 거대한 요청 대신 다음과 같이 집중된 이슈로 작업을 나눕니다:

1. Authentication module

   • 인증 모듈을 Go로 마이그레이션합니다.
   • 기존 모든 단위 테스트가 통과하도록 합니다.

2. Data‑validation utilities

   • 데이터 검증 유틸리티 패키지를 Go로 변환합니다.
   • 동일한 공개 API를 유지합니다.

3. User‑management controllers

   • 사용자 관리 컨트롤러를 Go로 다시 작성합니다.
   • 기존 REST 엔드포인트와 응답을 그대로 유지합니다.

이러한 원자적 작업으로 큰 문제를 나누면 다음과 같은 이점을 얻을 수 있습니다:

• 테스트 용이 – 각 부분을 독립적으로 검증할 수 있습니다.
• 리뷰 간소화 – 풀 리퀘스트가 작고 집중됩니다.
• 신뢰성 향상 – 실패가 전체 시스템이 아니라 단일 컴포넌트에 국한됩니다.

코딩 에이전트와의 페어링

코딩 에이전트와 작업할 때는 에이전트의 강점과 인간인 당신의 강점을 모두 기억하는 것이 중요합니다. 이 균형을 이해하면 협업이 원활해지고 에이전트가 기대와 다르게 행동할 때의 좌절감이 줄어듭니다.

인간이 잘하는 일

• Understanding the “Why” – 작업의 목적을 파악하고 제안된 변경이 근본적인 문제를 실제로 해결하는지 평가합니다.
• Navigating Ambiguity – 모호하거나 불완전한 요구사항을 다루어 코딩 에이전트가 명시적으로 필요로 하는 세부 정보를 채워 넣습니다.
• Cross‑System Thinking – 하나의 저장소에서 일어나는 변화가 다른 시스템에 어떻게 영향을 미칠지 예측합니다. 이는 에이전트가 놓칠 수 있는 부분입니다.

코딩 에이전트가 잘하는 일

• Tireless Execution – 피로 없이 동시에 여러 작업을 수행합니다.
• Repetitive Tasks – 많은 파일에 걸쳐 명명 규칙을 업데이트하거나 기타 반복적인 작업을 효율적으로 처리합니다.
• Exploring Possibilities – 여러 접근 방식을 빠르게 프로토타이핑하여 무거운 리소스 소모 없이 신속한 인사이트를 제공합니다.

Source: …

이것을 가지고 가세요

백로그에 남아 있던 문제들은 GitHub Copilot과 WRAP을 갖추면 더 이상 기회를 잡지 못합니다.

• 의존성을 업데이트해야 하나요?
• 테스트 커버리지를 늘리고 싶나요?
• 코드베이스 전반에 새로운 오류 처리 패턴을 도입하려고 하나요?
• GitHub Copilot 코딩 에이전트를 사용해 레포지토리 안내문을 빠르게 추가하고 싶나요?

WRAP을 사용해 백로그를 정리하세요!

GitHub Copilot 시작하기 →

---

작성자

Brittany Ellich – 소프트웨어 엔지니어, Platform & Enterprise, GitHub

Jason Etcovitch – 소프트웨어 엔지니어, Platform & Enterprise, GitHub

---

관련 게시물

(여기에 관련 기사 링크를 추가하세요)

---

GitHub에서 더 탐색해 보세요