# Agent NAS

> Agent NAS는 “실행”을 중심으로 설계한 네트워크 연결 스토리지입니다. 에이전트의 모든 실행은 격리된 브랜치에서 작업하고, 수명이 짧고 범위가 좁은 리스를 통해 데이터에 접근합니다. 모든 변경은 추적하고 되돌릴 수 있으며, 메모리는 출처를 가진 평범한 파일입니다. 에이전트가 이미 쓰는 파일, Git, S3, MCP로 접근할 수 있습니다.

상태: 개념 및 명세 초안 v0.2 (2026년 11월). 참조 구현은 아직 없습니다. 모든 페이지는 Markdown으로도 제공됩니다. 페이지 URL 뒤에 `index.md`를 붙이거나 `Accept: text/markdown`을 보내세요. 아래 링크는 Markdown 버전을 가리킵니다. 콘텐츠는 CC BY 4.0 라이선스로 제공됩니다.

## 시작하기

- [Agent NAS란?](https://agentnas.com/ko/what-is-agent-nas/index.md): Agent NAS는 에이전트의 “실행”을 중심으로 설계한 네트워크 연결 스토리지입니다. 정의, 갖춰야 할 여섯 가지 조건, 그것이 아닌 것, 필요 없는 경우를 설명합니다.
- [9가지 개념](https://agentnas.com/ko/concepts/index.md): Agent NAS는 작업, 권한, 지식의 세 그룹으로 나뉜 9가지 개념을 제안합니다. 개념마다 동작 방식과 작게 시작하는 방법, 솔직한 한계가 있습니다.
- [아키텍처](https://agentnas.com/ko/architecture/index.md): Agent NAS 아키텍처: 여섯 개의 명사 위에 쌓은 네 개의 계층과 선택 사항인 Sync, Store 계약, 한 번의 실행이 거치는 길, 배포 형태를 설명합니다.
- [인터페이스](https://agentnas.com/ko/interfaces/index.md): Agent NAS는 데이터를 마운트, Git, S3로, 제어를 MCP, HTTP, CLI로 제공합니다. 에이전트용 MCP 도구는 아홉 개이며, 모든 HTTP 호출은 JSON을 쓰는 POST입니다.
- [명세](https://agentnas.com/ko/spec/index.md): Agent NAS 명세 초안 v0.2: 구성 요소, 실행 가능한 인수 테스트를 갖춘 L0부터 L4까지 다섯 개의 적합성 수준, conformance.json 형식, 버전 정책.

## 9가지 개념

- [Agent Home (에이전트 홈)](https://agentnas.com/ko/concepts/agent-home/index.md): 역할마다 하나씩, 이력이 있는 디렉터리. 가지고 떠날 수 있는 평범한 파일.
- [Agent Branch (에이전트 브랜치)](https://agentnas.com/ko/concepts/agent-branch/index.md): 실행마다 쓰기 시 복사(copy-on-write) 브랜치에서 일합니다. 메인 라인에 닿는 것은 검토를 거친 병합뿐입니다.
- [Flight Recorder (플라이트 레코더)](https://agentnas.com/ko/concepts/flight-recorder/index.md): 실행마다 하나, 해시로 연결되며 읽은 것까지 담는 기록.
- [Capability Lease (권한 리스)](https://agentnas.com/ko/concepts/capability-lease/index.md): 한 번의 실행을 위한 좁은 인가. 만료 시점과 예산이 있고, 하위 리스는 더 좁아지기만 합니다.
- [Human Gate (사람 승인 게이트)](https://agentnas.com/ko/concepts/human-gate/index.md): 되돌릴 수 없거나, 외부로 나가거나, 권한을 높이는 동작 앞에만 나타나며, 실제 diff를 보여 줍니다.
- [Trust Labels (신뢰 라벨)](https://agentnas.com/ko/concepts/trust-labels/index.md): 작은 라벨 두 개와 세션 오염으로 Rule of Two를 강제합니다.
- [Agent Memory (에이전트 메모리)](https://agentnas.com/ko/concepts/agent-memory/index.md): 읽고 고칠 수 있는 노트가 진실입니다. 인덱스는 버려도 되는 캐시입니다.
- [Budgeted Reads (예산 읽기)](https://agentnas.com/ko/concepts/budgeted-reads/index.md): 파일을 개요, 섹션, 줄 범위, 전체로 읽되, 예산에 맞춰 단계적으로 낮춥니다.
- [Cascade Forget (연쇄 망각)](https://agentnas.com/ko/concepts/cascade-forget/index.md): 계보를 따라 파생물을 삭제하고, 이력은 보존 등급으로 다루며, 하지 못한 일을 보고합니다.

## 참고 자료

- [보안](https://agentnas.com/ko/security/index.md): Agent NAS의 보안 모델: 무엇을 지키고 무엇을 지키지 못하는지, 스토리지 경계에서 적용하는 Rule of Two, 통제를 갖춘 열 가지 위협, 솔직한 한계.
- [사용 사례](https://agentnas.com/ko/use-cases/index.md): Agent NAS 사용 사례: 밤새 도는 에이전트, 프레임워크를 바꿔도 유지되는 메모리, 팀의 공유 메모리, 사고 검토, 망각 요청, 그리고 쓰지 말아야 할 때.
- [비교](https://agentnas.com/ko/compare/index.md): Agent NAS가 NAS 제조사의 에이전트, 에이전트용 파일 시스템, 포크 가능한 스토리지, 메모리 도구, 샌드박스와 맺는 관계. 빌려 온 것과 새로운 다섯 가지.
- [로드맵](https://agentnas.com/ko/roadmap/index.md): Agent NAS 로드맵: 지금은 개념과 명세 초안, 다음은 Lite와 Overlay의 참조 구현, 그다음 이후의 작업, 그리고 하지 않을 것.
- [설계 원칙](https://agentnas.com/ko/principles/index.md): Agent NAS의 여덟 가지 설계 명제와 일곱 가지 베팅: 각각의 근거, 베팅이 틀렸을 때 설계가 어떻게 물러서는지, 무엇이 변하지 않아야 하는지.
- [자주 묻는 질문](https://agentnas.com/ko/faq/index.md): Agent NAS에 관한 자주 묻는 질문: 그것이 무엇인지, NAS 제조사의 에이전트와 어떻게 다른지, 프롬프트 인젝션, 망각, 쓰지 말아야 할 때, 진행 상황.
- [용어집](https://agentnas.com/ko/glossary/index.md): Agent NAS 용어집: 9가지 개념과 보조 용어의 정의. 주체, 실행, 읽기 매니페스트, 세션 오염, 보존 등급, 암호학적 파기 등을 하나씩 인용할 수 있게 정리했습니다.
- [프로젝트 소개](https://agentnas.com/ko/about/index.md): Agent NAS 프로젝트 소개: 상태, 라이선스, 거버넌스, 인용과 참여 방법, 에이전트를 위한 기계 판독용 자료(llms.txt, MCP, OpenAPI).

## 기계용 인터페이스

- [MCP](https://agentnas.com/mcp/server-card): 읽기 전용 MCP 서버 카드 (Streamable HTTP 엔드포인트: https://agentnas.com/mcp). 도구: search_docs, get_page, list_pages, get_briefing.
- [OpenAPI](https://agentnas.com/openapi.json): POST /api/search의 OpenAPI 설명 (JSON 입력, JSON 출력).
- [llms-full.txt](https://agentnas.com/ko/llms-full.txt): 전체 문서를 하나의 Markdown 파일로 묶은 것.
- [sitemap.xml](https://agentnas.com/sitemap.xml): 모든 언어의 모든 페이지 (hreflang 대체 링크 포함).

## Optional

- [English](https://agentnas.com/llms.txt)
- [简体中文](https://agentnas.com/zh-cn/llms.txt)
- [繁體中文](https://agentnas.com/zh-tw/llms.txt)
- [日本語](https://agentnas.com/ja/llms.txt)
- [Español](https://agentnas.com/es/llms.txt)
- [Français](https://agentnas.com/fr/llms.txt)
- [Deutsch](https://agentnas.com/de/llms.txt)
- [GitHub](https://github.com/xwzy/agentnas.com)