Model

에이전트 네이티브:
명확한 경계의
문서 모델

Nyxdoc은 읽기, 쓰기, 리뷰의 각 단계가 명확한 규약을 드러내야 한다는 원칙 위에 설계되었습니다. 이는 에이전트와의 협업을 불확실한 추측이 아닌, 검토와 신뢰가 가능한 시스템으로 전환합니다.

공통 운영 루프(Shared Operating Loop)
Read

컨텍스트 로딩 전 구조적 탐색

시스템은 문서 전체를 읽기 전 매니페스트와 블록 구조를 파악하여, 태스크 수행에 꼭 필요한 컨텍스트만 선별적으로 로딩합니다.

Write

리비전 경계 기반의 패치(Patch) 커밋

모든 변경 사항은 범위가 제한된 패치 단위로 제안되며, 명시적인 리비전 엣지를 기준으로 검증되어 투명한 감사 추적을 생성합니다.

Review

구조화된 작업 단위로서의 코멘트

코멘트는 의도와 우선순위, 범위를 포함한 실제 운영 단위가 되어 사람의 의사결정과 에이전트의 실행을 잇는 가교 역할을 합니다.

작고 조밀한 루프(Loop)를
설계하는 이유.

우리의 모델은 무분별한 재작성 대신 정밀한 스코프 지정을 지향합니다. 이러한 기술적 절제는 자동화를 더 강력하게 만들 뿐 아니라, 시스템의 예측 가능성과 신뢰를 담보합니다.

Read

운영 경계(Boundaries)의 중요성

통제되지 않는 자동화는 불안을 야기하지만, 명확한 경계는 자동화의 실질적인 효용을 극대화합니다.

Write

매니페스트 우선의 컨텍스트 로딩

기존 에이전트들이 단 몇 줄의 수정을 위해 방대한 문서를 재독하는 비효율과 취약성을 해결합니다. 매니페스트 모델은 문서 지도를 먼저 제공하여, 헤비한 데이터 호출 전 관련 블록으로 범위를 좁힙니다.

Review

상태와 생명주기를 갖춘 워크플로우 코멘트

코멘트는 의도와 우선순위, 범위를 포함한 실제 운영 단위가 되어 사람의 의사결정과 에이전트의 실행을 잇는 가교 역할을 합니다.

단순한 자동화가 아닌,
통제 가능한 범위 내에서의 실행이
핵심입니다.

01

사용자에 의한 정밀한 스코프 지정

태스크는 맥락 없는 막연한 요청이 아니라, 특정 블록이나 섹션 단위의 명확한 경계 안에서 시작됩니다.

02

되돌릴 수 없는 드리프트가 아니라 복구 가능한 작업

복구 불가능한 변동(Drift)이 아닌 안전한 복구 경로

03

막연한 전체 재작성 대신 범위 있는 실행

무분별한 전체 재작성 대신 범위 한정 실행(Scoped execution)

04

감독은 사후에 정보를 필사적으로 재구성하는 작업이 아니라, 제품 내부의 직관적인 인터페이스로 작동합니다.

안정적인 인터페이스, 가시화된 변경, 그리고 인간의 판단을 존중하는 Nyxdoc의 철학을 확인해 보세요.

정밀하게 읽기
안전하게 커밋하기
투명하게 리뷰하기

문서 전체를 다시 쓰는 방식은 책임 소재를 불분명하게 만듭니다. 변경은 사전 조건과 리비전 경계, 그리고 현재의 상태에 도달한 과정을 투명하게 설명하는 히스토리를 포함해야 합니다.