작업 이해하기06 / 20
의도별로 변경 읽기
이 페이지의 내용
Agent가 한 턴에 수십 개 파일을 바꾸면, diff를 파일별로 훑어서는 “이 변경들은 무엇을 위한 것인가?”에 답하기 어렵습니다. Noea에서는 한 턴의 변경 사항을 그것이 답하는 의도별로 묶을 수 있어서, 각 변경이 당신의 어느 문장을 위한 것인지 보입니다. 어떤 의도에도 답하지 않는 변경은 섞이지 않고 맨 끝에 따로 나열됩니다.
변경 카드에서 시작하기
턴이 파일 변경을 남기면 답변은 변경 카드로 끝납니다. 파일 하나가 바뀌었으면 제목이 “grace.ts 편집함”처럼 나오고, 여러 개면 “파일 9개 수정함”처럼 나오며 추가·삭제된 줄 수가 옆에 표시됩니다. Agent가 명령줄로 바꾼 파일도 포함됩니다.
Explain이 그 턴을 처리하고 나면 카드의 둘째 줄이 “의도 2개 · 미대응 1개”처럼 바뀝니다. 변경이 답하는 의도 부분이 몇 개이고, 어떤 의도에도 답하지 않는 변경이 몇 개인지입니다. 그 전에는 둘째 줄에 “설명을 실행해 묶기”가 나타납니다.
카드 아무 곳이나 클릭하면 메인 영역 맨 오른쪽의 보조 막대에 코드 패널이 열려, 그 턴의 모든 변경을 보여 줍니다. 채팅 자체에는 그 턴의 diff가 다시 나오지 않습니다.
코드 패널
패널 맨 위에는 채팅 제목과 “유예 기간 이메일 · 턴 2”처럼 턴 번호가 표시되며, 같은 채팅에서 변경이 있는 다른 턴으로 전환할 수 있습니다. 오른쪽 위 버튼은 파일 목록을 표시하거나 숨깁니다. 목록은 평면으로도, 폴더별로도 볼 수 있습니다. 각 파일에는 추가·삭제된 줄 수가 표시되고, 클릭하면 그 파일로 이동합니다. 모든 파일의 머리글에 “기본 앱으로 열기”가 있습니다.
diff에는 줄 번호 열이 하나뿐입니다. 추가된 줄과 변경 없는 줄은 새 번호를, 삭제된 줄은 흐리게 처리한 예전 번호를 표시합니다. 변경 사이의 변경 없는 줄은 한 행으로 접히며, 펼치면 파일 전체까지 볼 수 있습니다. 그 턴 이후에 파일이 또 바뀌었다면 패널에는 이번 턴의 변경만 표시되고 “현재 파일 보기”가 나타납니다.
보조 막대의 왼쪽 가장자리를 끌면 패널이 넓어집니다. 닫아도 보조 막대만 접힐 뿐, 왼쪽의 문서와 채팅은 그대로 있습니다.
의도별로 묶기
패널에는 “파일별”과 “의도별” 두 가지 배열이 있습니다. 의도별로 보면 다음과 같습니다.
- 각 묶음은 의도의 한 부분입니다. 머리글은 그 단락의 글이며, 위에 작게 그것이 속한 문서와 절이 표시됩니다. 묶음은 의도 문서의 단락 순서를 따릅니다.
- 묶음 안에서는 변경이 핵심 요점별로, 그다음 파일별로 배열됩니다. 핵심 요점마다 이름이 소제목으로 나오고, 그 뒤에 작은 글씨로 구현의 첫 문장이 이어집니다.
- 각 변경은 한 번만 나옵니다. 여러 핵심 요점에 답한다면 주된 요점 아래에 놓이고, 나머지는 칩으로 매달립니다.
- 마지막 묶음은 항상 “기타 변경”이며, 어떤 의도에도 답하지 않는 변경이 들어갑니다.
패널이 어떤 배열로 열리는지는 Explain이 그 턴을 어디까지 처리했는지에 따라 다릅니다.
| Explain 상태 | 열리는 방식 |
|---|---|
| 아직 그 턴을 처리하지 않음 | 파일별 |
| 진행 중이며, 이 턴과 연결된 설명이 이미 있음 | 첫 설명이 게시되면 의도별로 전환됩니다. 아직 조사 중인 단락은 자기 묶음 안에 자리를 잡아 둡니다 |
| 정상적으로 끝남 | 의도별 |
| 조사할 단락을 찾지 못함 | 파일별, “이 턴은 설명된 의도를 건드리지 않았습니다.”라는 안내와 함께 |
언제든 파일별로 되돌아갈 수 있습니다.
각 변경이 답하는 것
각 변경에는 당신의 의도가 가벼운 것에서 자세한 것 순서로 세 겹으로 나타납니다.
- 줄 옆의 표시: 설명이 명시적으로 인용한 줄의 왼쪽에는 가는 중립색 표시가 있습니다. 가리키면 같은 설명이 인용한 다른 줄이 강조되고 의도의 이름이 보입니다.
- 의도 칩: 변경이 답하는 핵심 요점이 머리글에 최대 두 개까지 매달리고, 나머지는 “+의도 N개”로 접힙니다. 칩을 가리키면 단락과 그 설명의 첫 문장이 미리 보이고, 클릭하면 옆 창에 문서가 그 설명이 열린 채로 나타납니다.
- 의도 블록: 각 변경 아래에는 “의도 2개 · 격차 1개” 같은 접힌 요약 줄이 있습니다. 열면 그 변경이 답하는 각 단락의 글이, 최신 설명의 주의 사항과 함께 나옵니다.
변경이 당신의 의도와 연결되는 방식은 세 가지입니다. “설명이 인용”은 설명이 이 줄들을 명시적으로 인용했다는 뜻입니다. “줄로 일치”는 변경이 설명이 인용한 줄 범위 안에 든다는 뜻입니다. “영향 없음으로 판정”은 Explain이 그 변경을 확인했고 그 단락에 영향이 없다고 판단했다는 뜻입니다. 파일 대부분을 차지하는 변경이나, 이전 내용을 Noea가 읽은 것이 아니라 Agent가 보고한 변경은 줄로 일치시키지 않으며, 패널에 “줄 범위로 분류하지 않음”으로 표시됩니다.
의도의 한 부분만 걸러 보기
파일 목록 맨 위의 “의도로 필터”를 쓰면 단락 하나 또는 핵심 요점 하나에 대한 변경만 보입니다. “대응하는 의도 없음”을 고르면 어떤 의도에도 답하지 않는 변경만 보입니다.
반대로 의도에서 변경으로 갈 수도 있습니다. 의도 문서에서 단락의 설명을 열면, 메모 끝의 “최근 구현”이 그 단락을 최근에 바꾼 턴을 나열합니다. 하나를 열면 코드 패널이 그 턴에서, 이 단락으로 이미 필터링된 채로 열립니다.
읽고 난 뒤
“기타 변경”이 반드시 문제인 것은 아닙니다. 테스트 도우미, 서식, 의존성 업그레이드인 경우가 많습니다. 하지만 비즈니스 로직의 변경이 어떤 의도에도 답하지 않는다면, 왜 바뀌었는지, 그것이 당신의 의도에 들어가야 하는지 물어볼 만합니다.
채팅에서 Agent에게 물어보거나, 단락 왼쪽의 “이 부분에 대해 질문”을 클릭하세요. 남겨 두고 싶은 결정은 정한 내용을 의도로 적기를 참고하세요.
묶기는 Explain의 결과에 달려 있습니다. 카드에 계속 “설명을 실행해 묶기”가 표시된다면 설정 → 자동화에서 “구현 후 자동으로 설명”과 “코드만 바꾼 턴 설명”을 확인하거나, 그냥 클릭하세요. 코드가 바뀌었을 때를 참고하세요.