덜 읽기
핵심 구조와 필요한 블록 단위의 컨텍스트 로딩
단 하나의 태스크를 처리하기 위해 에이전트가 문서 전체를 매번 다시 읽어들일 필요는 없습니다.
에이전트 시대를 위한 새로운 문서 체계
사람의 생각과
에이전트의 실행이
만나는 공간
Nyxdoc은 에이전트 도입으로 워크플로우의 복잡도가 높아진 팀을 위해 체계적인 문서 환경을 구축하고 있습니다.
가독성 높은 구조, 통제 가능한 변경, 그리고 견고한 리뷰 체계는 파편화된 절차를 억지로 이어 붙인 결과물이 아니라 제품 그 자체에 내재되어야 합니다.
안전하게 바꾸기
문서 작성을 범위가 명확한 패치(Patch) 단위로 전환
제대로 된 실행이란 무분별한 재작성이 아니라, 수정 범위를 제한하고 의도를 명확히 밝히며 변경 이력을 검토 가능한 상태로 유지하는 것입니다.
신뢰 유지
히스토리와 롤백을 인터페이스의 일부로 녹여내기
무엇이 왜 변했는지, 어떻게 되돌리는지가 선명하게 보일 때 비로소 시스템에 대한 확신이 생깁니다.
왜 지금 중요한가
다음 문서 레이어는 사람과 에이전트를
동시에 지원해야 합니다.
에이전트가 구현과 운영의 영역에 진입할수록, 병목 지점은 모델 성능이 아닌 컨텍스트의 품질로 이동합니다. 파편화된 구조는 협업의 노이즈를 만들지만, 탄탄한 구조는 문서를 신뢰할 수 있는 작업 환경으로 탈바꿈시킵니다.
압력
에이전트는 더 이상 단순한 실험 대상이 아닙니다.
에이전트는 이미 실제 업무 루프의 핵심이 되었지만, 여전히 대다수의 문서는 사람이 행간을 읽어줄 것이라는 암묵적인 가정 하에 머물러 있습니다.
파손
정적인 페이지는 불필요한 컨텍스트 재로딩을 유발합니다.
전체 문서를 다시 읽어야 하는 구조, 모호한 수정 범위는 자동화 루프의 비용과 부하를 가중시킵니다.
전환
실행 품질은 결국 문서 품질에서 시작됩니다
사람과 에이전트 사이에서 의도와 변경 상태, 업무의 연속성을 명확히 공유하는 팀이 결국 앞서나갑니다.
결과
지식은 보관이 아니라 운영이 됩니다
문서는 단순한 설명을 넘어 실행과 리뷰, 복구와 연속성까지 포괄하는 운영의 토대가 되어야 합니다.
Nyxdoc이 만드는 것
에이전트를 전제로 한
문서 운영 모델.
우리는 단순한 위키 도구를 만드는 것이 아닙니다. 읽기, 쓰기, 리뷰의 모든 단계가 명확한 규약(Contract) 하에 시각화되는 문서 시스템을 구축하고 있습니다.
Read
manifest-first 컨텍스트 로딩
전체 구조를 먼저 파악한 뒤, 현재 작업에 꼭 필요한 블록 단위의 컨텍스트만 선별적으로 로딩합니다.
Write
패치(Patch)와 커밋(Commit)을 핵심 동작으로 정의
수정 사항은 문서 전체를 덮어쓰는 방식이 아니라, 기여자와 버전 정보가 명확히 남는 단위로 기록되어야 합니다.
Review
범위와 상태를 담는 코멘트
커뮤니케이션은 사람의 지시가 에이전트의 실행으로, 다시 차분한 검토(Calm review)로 이어지게 돕는 가교가 됩니다.
제품이 지켜야 할 것
운영의 번거로움 없이,
에이전트의 모든 움직임을
선명하게 드러냅니다.
우리는 팀이 좁은 작업을 안심하고 위임할 수 있게 해 주는 도구를 원합니다. 분명한 경계, 오래 남는 히스토리, 그리고 모든 걸 다시 머리로 재구성하지 않아도 되는 리뷰 경험 말입니다.
통제
신뢰는 보이는 변경에서 옵니다
변경 이력(Diff)과 롤백, 기여 기록은 부가 기능이 아니라 에이전트와의 협업을 지탱하는 제품의 핵심 인터페이스입니다.
핸드오프
컨텍스트는 세션과 기여자를 건너 살아남아야 합니다
다음 작업자나 에이전트가 곧바로 업무 맥락을 파악할 수 있도록, 시스템이 의도와 범위, 수정 상태를 기억해야 합니다.
절제
사람의 판단은 필요한 순간에 더 또렷해야 합니다
중요한 것은 에이전트가 문서를 "읽는" 수준을 넘어, 문서가 사람의 판단과 에이전트의 실행을 어떻게 신뢰 가능한 방식으로 연결하느냐입니다.
“중요한 것은 에이전트가 문서를 "읽는" 수준을 넘어, 문서가 사람의 판단과 에이전트의 실행을 어떻게 신뢰 가능한 방식으로 연결하느냐입니다.”
우리가 향하는 방향
현실적인 실행 루프에서
시작합니다.
사람이 범위가 있는 지시를 남기고, 에이전트는 최소한의 맥락만 읽고, bounded patch가 리뷰로 돌아오고, 시스템은 그 상태를 오래 남깁니다.
Foundation
직접 참조 가능한 구조와 버전 관리 기반의 히스토리
block-level addressing, partial fetch, 그리고 durable operational memory를 담을 수 있는 document model.
Workflow
의도를 실행으로 잇는 코멘트
논의 과정은 맥락 없이 흩어진 소통 채널이 아니라, 구조화된 업무 접수(Work intake) 창구가 되어야 합니다.
Confidence
처음부터 내장된 review, rollback, attribution
무슨 일이 일어났는지 보고, 필요하면 extra process glue 없이도 깨끗하게 복구할 수 있을 때 신뢰가 생깁니다.