설명을 최신 상태로 유지하기

의도나 코드를 변경한 뒤에는 설명이 여전히 유효한지 확인하세요. 사이드바의 설명으로 프로젝트 전체에서 확인이 필요한 설명을 처리하거나, 단락의 조사 동작으로 특정 내용만 확인할 수 있습니다.

변경된 내용 파악하기

상태	의미	다음 단계
조사할 내용	새로 작성하거나 편집한 문구에 자체 설명이 없습니다.	저장한 뒤 조사합니다. 요구사항을 아직 충족하지 못한다면 먼저 구현합니다.
이전 텍스트의 설명	단락은 바뀌었지만 메모는 이전 문구를 설명합니다.	텍스트 차이를 살펴보고 다시 조사합니다.
오래되었을 수 있음	설명이 읽거나 인용한 파일이 변경되었습니다.	변경된 파일을 살펴보고 설명을 다시 확인합니다.
발견된 변경 사항 없음	조사를 기다리거나 오래되었을 수 있다고 표시된 내용이 없습니다.	필요에 따라 계속 읽거나 특정 질문을 검증합니다.

“오래되었을 수 있음”이 반드시 잘못된 결론을 뜻하지는 않습니다. 파일 변경이 설명과 관계없을 수도 있습니다. “발견된 변경 사항 없음” 역시 테스트 통과나 모든 기능의 완성을 증명하지 않습니다.

문서를 저장하고 단락에 포인터를 올린 뒤 왼쪽의 조사를 선택하세요. 기존 여백 메모에 다시 조사가 제공되기도 합니다.

선택한 내용의 설명만 갱신합니다. 해당 내용에 저장하지 않은 변경 사항이 있으면 조사할 수 없으며 Noea가 먼저 저장하라고 안내합니다.

예를 들어 보상 중복 지급을 막는 코드를 수정했다면 해당 규칙을 조사해 설명이 현재 구현을 다루는지 확인하세요.

사이드바의 설명을 클릭하면 조사를 기다리는 내용과 근거 파일이 변경된 설명을 확인합니다. 프로젝트가 열려 있지 않거나, 읽기 전용이거나, 연결된 구현 폴더가 없으면 사용할 수 없습니다.

수동으로 시작한 설명 작업은 단계, 진행 상황, 개별 결과를 보여 주는 채팅을 엽니다. 실행 중에는 그 채팅에 일반 메시지를 보낼 수 없지만 프로젝트의 다른 채팅은 사용할 수 있습니다.

끝나면 결과를 펼쳐 어떤 설명이 바뀌었고, 어떤 설명이 여전히 맞으며, 어떤 확인이 실패하거나 완료되지 않았는지 살펴보세요. 작업이 끝났다고 모든 확인이 성공한 것은 아닙니다.

설명은 의도와 코드를 비교하고 단락 설명과 부분 설명을 모두 확인합니다. 정확한 내용은 유지하고 수정이 필요한 부분을 갱신하며, 반드시 모든 설명을 다시 쓰지는 않습니다.

설명이 갱신되었다고 테스트가 다시 실행되었다는 뜻은 아닙니다. 동작을 검증하려면 일반 채팅에서 확인 작업을 요청하고 그 뒤 관련 내용을 조사하세요. 검증 범위를 해석하는 방법은 설명과 근거 읽기를 참고하세요.

설정 → 현재 프로젝트 → 자동화 → 구현 후 자동으로 설명은 기본으로 켜져 있습니다. 주요 실행 조건은 다음과 같습니다.

동작	자동 설명
의도를 바꾸고 아직 구현이 필요한 제안을 수락.	해당 구현 작업이 정상적으로 끝난 뒤 실행됩니다.
의도를 바꾸지만 기존 구현이 이미 충족하는 제안을 수락.	수락한 뒤 실행됩니다.
사이드바의 구현으로 작업을 시작.	첫 번째 턴이 정상적으로 끝난 뒤 실행됩니다.
의도 텍스트를 변경하는 정리안을 수락.	위 설정과 관계없이 수락한 뒤 실행됩니다.
파일 이름이나 폴더 구조만 정리.	실행되지 않습니다.
일반 채팅에서 코드만 변경하거나, 직접 구현을 선택하거나, 구현이 실패 또는 중지됨.	실행되지 않습니다. 설명을 수동으로 실행하세요.

자동 설명은 일반 채팅을 만들지 않고 백그라운드에서 실행됩니다. 원래 채팅을 계속 사용하면서 실행에서 진행 상황을 확인하세요.

사이드바의 실행 섹션에 설명 작업이 보관됩니다. 작업을 펼치면 각 실행의 읽기 전용 기록을 볼 수 있습니다. 채팅을 바꾸거나 앱을 다시 시작해도 기록은 유지됩니다.

실패하거나 중단되었다면 다시 실행을 선택하세요. 기존 설명은 유지됩니다. 새 실행이 끝나면 이전에 실패했거나 미완료였던 항목이 처리되었는지 확인하세요.

설명에 사용하는 에이전트는 작업이 어떻게 시작되었는지에 따라 달라집니다. 프로젝트 동작 설정과 적용 범위는 에이전트, 모델 및 사용량을 참고하세요.

설명이 갱신되지 않으면 문제 해결과 자주 묻는 질문을 참고하세요.