이슈에서 시작하는 작업
깃허브는 2024년 4월 29일 코파일럿 워크스페이스를 기술 프리뷰로 공개했다. 저장소의 특정 이슈처럼 할 일을 담은 문서에서 출발해, 자연어로 변경을 설명하고 코드를 구현하고 시험할 수 있는 환경으로 소개했다. 깃허브 발표는 대기 명단을 안내했고, 개발팀 변경 기록은 같은 날짜에 첫 공개가 이뤄졌음을 확인해 준다. 이용 신청을 받았다는 사실을 모든 개발자에게 정식으로 제공했다는 뜻으로 읽을 수는 없다. [1][2]
코드 편집기에서 입력 중인 한 줄을 완성하는 도구와 달리, 워크스페이스가 다루려는 입력은 작업의 목적이었다. 기존 저장소에 기능을 추가하려면 어떤 동작이 있는지, 무엇이 빠졌는지, 어느 부분을 고쳐야 하는지를 먼저 설명해야 한다. 이슈의 제목이나 설명은 그 과정을 시작하는 재료다. 이슈에 답이 모두 들어 있다거나, 저장소 안의 다른 요구를 대신한다는 뜻은 아니다. [1]
깃허브의 공개 흐름에서는 먼저 현재 동작과 바라는 동작을 명세로 표현했다. 현재 상태가 틀리면 고쳐야 할 대상을 처음부터 잘못 잡을 수 있다. 예를 들어 가상의 달력 앱에서 월요일 시작 옵션이 이미 모바일 화면에 있다고 가정하자. 이슈가 웹 화면을 말하는데 기존 옵션이 없다고 정리하면 이미 있는 기능을 다시 만들거나 두 화면의 설정을 불필요하게 분리할 수 있다. [1]
명세와 변경 계획의 차이
명세가 무엇을 달성해야 하는지 설명한다면, 계획은 어떤 파일과 절차로 그것을 달성할지 제안한다. 같은 기능도 기존 설정을 재사용하거나 새 저장 방식을 도입하는 등 구현 경로가 여러 가지다. 명세와 계획을 나누면 요구가 잘못된 것인지, 요구는 맞지만 접근 방식이 좋지 않은지를 코드가 쌓이기 전에 구별할 수 있다. [1]
깃허브는 제안된 계획과 코드를 개발자가 편집할 수 있다고 강조했다. 이것이 중요한 이유는 결과에서 틀린 줄을 삭제하는 것만으로는 변경 전반에 퍼진 오해를 고치기 어렵기 때문이다. 가령 앱 전체에서 바꾸라는 제안을 특정 화면으로 좁혀야 한다면, 바라는 동작과 범위를 먼저 고치고 그에 맞는 계획을 검토하는 편이 일관성을 지키기 쉽다. [1]
반대로 사람이 명세를 손봤다는 사실이 코드의 정확성을 증명하지는 않는다. 코드 변경에는 의존성, 접근 권한, 이전 버전과의 호환 등 계획에 드러나지 않은 문제가 남을 수 있다. 개발자는 변경 내역에서 삭제되거나 새로 추가된 줄을 보면서 원래 이슈와 비교해야 한다. 문서로 설명할 수 있는 것과 실행해서 확인해야 하는 것을 함께 다룰 수 있게 한 것이 당시 공개 흐름의 특징이었다. [1]
실행 결과와 병합은 또 다른 판단
프리뷰는 코드를 빌드하거나 시험할 수 있는 흐름을 보여 줬다. 테스트를 실행할 수 있다는 것과, 적절한 테스트가 존재하고 통과했다는 것은 다르다. 가상의 달력 기능이라면 정상적인 한 주를 표시하는지 외에도 주가 달 경계를 넘을 때나 사용자의 지역 설정이 다를 때 어떤 동작을 하는지 살펴야 한다. 워크스페이스가 만든 코드라도 어떤 테스트가 필요한지 결정하는 책임은 개발 과정에 남는다. [1]
풀 리퀘스트는 바꾼 내용을 검토하도록 올리는 단위다. 초안을 올리는 것과 변경이 저장소에 병합되어 사용자에게 전달되는 것 사이에는 코드 검토와 자동 검사, 저장소 운영 규칙이 있다. 기술 프리뷰의 소개에서 이슈로 시작해 변경을 준비한다는 부분만 보고, 그 사이의 단계나 프로젝트 관리자의 판단까지 제품이 자동으로 처리했다고 확대해서는 안 된다. [1][2]
개발팀이 4월 29일 기술 프리뷰를 내놓으며 보여 준 변화는 코드 한 줄을 추천하는 범위를 넘어, 변경 작업을 작은 판단으로 나눈 데 있었다. 명세가 작업의 목적을 보존하고, 계획이 구현 범위를 보여 주고, 코드와 테스트가 실제 행동을 확인하게 한다. 당시 발표를 읽을 때에는 이 흐름과 프리뷰의 이용 범위를 함께 보면 제품이 해결하려던 문제와 남은 일을 구분할 수 있다. [1][2]
어느 단계의 제안을 고치는 게 효과적인가
명세가 도움이 되는 경우와 계획이 도움이 되는 경우도 구분할 수 있다. 문제를 재현하는 조건이 애매하면 코드를 먼저 쓰기보다 실제 동작과 바라는 동작을 다시 적는 편이 효율적이다. 반대로 요구가 분명한데 변경 대상이 지나치게 넓으면, 우선 계획에서 건드릴 파일의 범위를 줄이는 편이 적절하다. 편집 가능한 중간 제안은 개발자가 그런 선택을 결과가 나온 뒤에만 하지 않아도 되게 한다. [1]
예를 들어 날짜 계산을 고쳐야 할 때 계획이 화면 표시 코드를 바꾸겠다고 제안했다고 하자. 오류가 저장된 날짜의 시간대 처리에서 생겼다면, 겉으로 보이는 표시만 바꾸는 조치는 다른 화면에 같은 문제를 남길 수 있다. 바라는 동작이 맞더라도 오류가 생기는 지점까지 맞게 찾았는지 확인하는 일이 필요하다. 제안의 설명을 남겨 두면 나중에 코드를 검토하는 사람이 왜 그 파일을 변경했는지 되짚기 쉽다.
또 프리뷰라는 공개 형태는 기능을 설명한 글과 이용 가능 범위를 따로 읽어야 하는 이유다. 소개 글에 예시 화면이 있고 작업 순서가 자세히 나와도, 당시 모든 저장소와 계정에서 그 순서를 쓸 수 있었다고 판단할 수는 없다. 4월 29일 공식 소개 글의 대기 명단 안내와 개발 기록의 첫 공개 항목을 함께 보면 당시 이용 범위를 확인할 수 있다. 이 글은 그 주에 소개된 작업 방식을 기록한 것으로, 이후 제품의 제공 상태를 설명하지 않는다. [1][2]
