Noea Code 소개

Noea Code(이하 Noea)는 AI로 소프트웨어를 개발할 때 동작 방식을 이해하고 결정하도록 돕습니다. 요구사항을 작성하면 코딩 에이전트가 코드를 수정하고, 사용자는 구현 설명과 근거, 주의 사항을 통해 결과가 기대에 맞는지 확인합니다.

기존 프로젝트의 규칙 하나부터 시작하세요. 제품의 동작, 아키텍처 제약, 알고리즘 요구사항 모두 첫 번째 의도가 될 수 있습니다.

의도는 소프트웨어가 계속 충족하기를 바라는 요구사항입니다. 기능을 완성한 뒤에도 여전히 유효합니다. 동작을 바꾸기로 결정하면 해당 문구를 수정합니다. 애플리케이션 전체를 설명할 필요는 없습니다. 자신에게 중요한 것부터 시작하세요.

의도와 구현 연결하기

매일 출석하는 앱을 만들면서 다음과 같이 작성했다고 가정해 보겠습니다.

사용자가 7일 연속 출석하면 보상을 지급한다.

이 문장은 보상 지급 조건을 정하지만, 하루의 기준, 출석을 빠뜨렸을 때의 처리, 보상의 종류 등은 정하지 않습니다. 에이전트는 규칙을 구현하면서 이러한 사항도 결정해야 합니다.

Noea는 이 문장을 구현 설명과 연결합니다. 코드가 날짜를 어떻게 계산하는지 읽고, 설명의 바탕이 된 코드 참조나 테스트 자료를 열어 보고, 충족하지 못한 요구사항이나 논의할 만한 선택을 찾을 수 있습니다. 하루의 기준을 사용자 현지의 달력 날짜로 정하기로 했다면, 앞으로의 작업에서도 지키도록 그 결정을 의도에 추가하세요.

세 가지 콘텐츠 구분하기

의도 문서는 Markdown 파일입니다. Git으로 변경 이력을 관리하거나 다른 편집기로 수정할 수 있습니다. Noea는 구현 설명을 별도로 저장해 여백 메모에 표시합니다. 영어 인터페이스의 일부 항목은 의도 문서를 Source라고 부르며, 한국어에서는 소스로 표시합니다. 이는 구현 폴더 안의 코드와 다릅니다.

일상적인 작업 흐름 따라가기

1. 의도를 명확히 합니다. 직접 작성하거나 에이전트와 논의한 뒤 제안된 문구를 검토합니다.
2. 구현하고 이해합니다. 에이전트가 작업한 뒤 구현을 조사하고 설명, 근거, 주의 사항을 읽습니다.
3. 결정을 기록합니다. 특정 단락에 대해 질문하고 유지하고 싶은 요구사항을 추가하면서 구현과 확인을 이어갑니다.

코드가 이미 있다면 확인할 요구사항을 작성하고 설명을 실행하세요. 아직 구현이 필요하다면 채팅이나 구현 동작을 사용하세요.

이해한 선택을 받아들이더라도 모든 구현 세부 사항을 지속적인 요구사항으로 만들 필요는 없습니다. 무엇을 의도에 넣을지 결정하려면 설명과 근거 읽기를 참고하세요.

Noea와 에이전트의 역할 이해하기

Noea는 문서 작성, 의사결정 논의, 변경 사항 검토, 설명 읽기를 위한 작업 공간을 제공합니다. 에이전트는 프로젝트를 읽고 도구를 호출하며 코드를 수정합니다. 지원되는 에이전트를 선택하고 해당 에이전트가 제공하는 모델과 로그인 방식을 사용하세요.

Noea의 제안 흐름에서 의도 문서를 변경하려면 사용자의 결정이 필요합니다. 제안을 수정해 수락하거나 무시할 수 있습니다. 코드 수정과 명령 실행은 에이전트의 기능 및 권한 설정에 따라 달라집니다.

구현 설명은 테스트나 직접 사용해 보는 과정을 대신하지 않습니다. 중요한 동작은 근거를 확인하고 필요에 따라 검증하세요.

작지만 의미 있는 질문부터 시작하기

보상이 지급되는 시점, 재고가 부족할 때의 처리, API가 지켜야 할 제약처럼 범위가 좁고 결과를 관찰할 수 있는 대상을 고르세요. 프로젝트의 나머지 부분은 기존 개발 방식을 계속 사용해도 됩니다.

이제 설치와 준비를 마치고 첫 번째 작업 흐름을 따라가 보세요.