첫 번째 작업 흐름

이 튜토리얼에서는 출석 보상 예제로 첫 의도를 작성하고, 확인하거나 구현하고, 새로운 결정을 기록합니다. 프로젝트의 실제 코드와 검증 결과를 바탕으로 요구사항의 충족 여부를 판단하는 방법을 익힐 수 있습니다.

준비됨 상태의 에이전트가 있는 Noea와 작업할 로컬 프로젝트가 필요합니다. 프로젝트에 출석 기능이 없다면 비슷하게 구체적인 다른 규칙으로 바꾸어 따라 하세요.

코드 프로젝트 열기

작업 공간의 폴더 열기… 또는 파일 → 구현 폴더 열기…를 선택하고 코드가 있는 폴더를 지정하세요.

해당 폴더를 처음 열면 Noea가 연결된 프로젝트를 만듭니다. 기존 프로젝트가 하나 있으면 바로 열고, 연결된 프로젝트가 여러 개면 선택을 요청합니다. 다른 여는 방법은 프로젝트 열기와 관리를 참고하세요.

첫 번째 의도 작성하기

사이드바에서 새로운 의도를 클릭하고 이름을 “매일 출석”으로 지정하세요. Noea가 .noea.md 확장자를 붙이고 문서를 엽니다. 다음과 같이 작성하세요.

# 매일 출석

사용자는 하루에 한 번 출석할 수 있다. 사용자가 7일 연속 출석하면 보상을 지급한다.

macOS에서는 ⌘S, Windows / Linux에서는 Ctrl+S로 저장합니다. 결정한 내용부터 시작하세요. 아직 모든 예외 상황을 나열할 필요는 없습니다.

조사와 구현 중 선택하기

설명은 프로젝트 전체에서 설명을 확인해야 하는 내용을 점검합니다. 단락의 조사 동작은 해당 내용만 확인합니다. 둘 다 구현을 살펴보고 설명을 생성하거나 갱신하며, 코드는 수정하지 않습니다.

출석 기능이 이미 있다면 사이드바에서 설명을 클릭하세요. 이 단락만 확인하려면 단락에 포인터를 올리고 왼쪽의 조사를 선택하세요.

규칙을 아직 구현해야 한다면 새 채팅을 시작하고 입력란에 @를 입력해 의도 문서를 선택한 뒤 다음 메시지를 보내세요.

참조한 의도에 따라 이 프로젝트에 출석 보상을 구현해 주세요. 먼저 기존 코드를 살펴보고 프로젝트 구조를 따르면서, 7일 연속 출석과 출석을 빠뜨린 경우를 모두 검증해 주세요.

사용할 수 있다면 사이드바의 구현 버튼을 이용해도 됩니다. 에이전트와 함께 구현하기를 참고하세요. 에이전트가 작업하는 동안 채팅에 답변, 도구 호출, 파일 변경 사항이 표시됩니다.

구현 후 자동으로 시작되지 않았다면 설명을 클릭하세요. 일반 채팅에서 코드를 변경했다고 항상 설명 갱신이 실행되는 것은 아닙니다.

구현 설명 읽기

의도 문서로 돌아와 단락 안에서 텍스트 바깥의 빈 공간을 클릭하면 여백 메모가 열립니다. 다음 섹션을 읽어 보세요.

• 구현: 코드가 연속 일수를 계산하고 보상을 지급하는 방식입니다.
• 근거: 설명에서 인용한 코드, 명령 출력, 테스트 자료입니다.
• 주의 사항: 사용자의 판단이 필요한 미충족 사항, 구현 선택, 위험, 제안입니다.

예를 들어 구현이 기기의 시간대를 기준으로 달력 날짜를 정의한다는 사실을 알게 될 수 있습니다. 프로젝트가 실제로 어떻게 동작하는지, 요구사항과 맞는지 확인하세요. 참조를 열어 근거가 설명을 어디까지 뒷받침하는지도 살펴보세요.

설명이 완료되었다고 테스트를 다시 실행했다는 뜻은 아닙니다. 테스트 코드, 과거 결과, 이번 실행에서 수행한 검증을 구분하세요. 설명과 근거 읽기를 참고하세요. 구현이 원래 요구사항을 충족하지 못했다면 코드에 맞게 규칙을 다시 쓰기보다 구현을 수정하세요.

질문하고 결정 기록하기

단락에 포인터를 올리고 왼쪽의 이 부분에 대해 질문을 선택하세요. Noea가 채팅 입력란에 참조를 넣습니다. 질문을 추가해 보내세요.

현재 구현은 시간대를 넘나드는 여행을 어떻게 처리하나요? 서로 다른 두 장소에서 출석하면 연속 기록에 영향을 줄 수 있나요? 코드를 근거로 설명해 주세요.

동작을 이해한 뒤 계산 방식에 제약을 둘지 결정하세요. 제약을 두려면 다음과 같이 보내세요.

이 의도에 “하루는 사용자의 현재 위치에서의 달력 날짜를 따른다”를 추가해 주세요. 먼저 제가 검토할 수 있도록 의도 변경을 제안해 주세요.

에이전트가 제안을 제출하면 변경 사항 보기를 클릭하고 추가되거나 대체될 문구를 읽습니다. 필요하면 새 문구를 편집한 뒤 내 편집 내용 수락을 선택하세요. 편집할 필요가 없으면 수락을 선택합니다.

제안에 구현 작업이 필요하면 수락 후 같은 채팅에서 작업이 이어집니다. 기존 구현이 이미 충족한다면 새 구현 실행은 필요하지 않습니다. 이후 설명 작업의 결과를 확인하거나 필요할 때 수동으로 조사하세요.

배운 내용 확인하기

마치기 전에 문서를 저장하고 설명이 현재 문구를 다루는지 확인하세요. 다음 네 가지 질문에 자신의 말로 답해 보세요.

1. 이 요구사항은 어떻게 구현되어 있으며, 그 결론을 뒷받침하는 근거는 무엇인가요?
2. 의도에 명시되지 않았지만 에이전트가 내린 중요한 결정은 무엇인가요?
3. 그 결정을 이해하고 받아들이나요? 지속적인 제약으로 만들어야 할까요?
4. 다음에 이 동작을 바꾸고 싶다면 어느 문장을 수정하면 될까요?

예를 들어 하루의 정의를 설명하고, 이를 뒷받침하는 근거를 찾고, “7일 연속”이 보상 조건임을 짚을 수 있어야 합니다. 답이 명확하지 않다면 해당 단락에 대해 질문하세요.

첫 사용에서 모든 규칙을 기록할 필요는 없습니다. 유지할 만한 다음 결정을 만나면 그때 추가하세요.

이어서 중요한 의도 작성하기와 설명과 근거 읽기를 읽어 보세요.