ONEDEV

dox

agent0ai파일 5개

★ 1,481주당 +9조회 5

무엇인가

DOX는 프로젝트 문서를 AGENTS.md 계층으로 유지하도록 에이전트에 절차를 주입하는 규칙 파일이다. 규율 대상은 편집 전 컨텍스트 확보와 편집 후 문서 동기화이며, 코드 생성 방식이 아니라 코드를 건드리기 전에 읽어야 할 지역 규칙을 정하는 영역을 다룬다.

어떻게 동작하나

동작은 파일 계층과 순회 절차로 이뤄진다. 루트 AGENTS.md가 프로젝트 전역 지침과 최상위 인덱스를 담고, 하위 AGENTS.md가 특정 영역의 지역 지침을 담는다. 에이전트는 편집 전 루트에서 대상 영역까지 문서 트리를 따라 내려가 해당 지역 규칙을 확인하고, 의미 있는 변경 후에는 영향을 받은 AGENTS.md를 갱신한다. 훅이나 슬래시 명령이 아니라 AGENTS.md 자동 로드로 발동한다.

무엇과 다른가

단일 규칙 파일을 한 번 작성해 두는 방식과 달리, DOX는 문서 트리를 유지하는 절차 자체를 규칙 안에 포함한다. 프롬프트를 매번 직접 쓰는 방식은 세션마다 컨텍스트가 초기화되지만, DOX는 영역별 지침을 파일로 남겨 재사용한다. 설치물·패키지·런타임이 없고 Markdown 지침만 존재한다는 점에서 도구가 아니라 규약에 가깝다.

어떻게 쓰나

사용법은 프로젝트의 AGENTS.md 파일에 DOX의 AGENTS.md 내용을 복사하는 것이다. AGENTS.md가 없으면 프로젝트 루트에 그대로 두면 되고, 에이전트가 이 지침을 읽고 DOX 트리를 만들기 시작한다. 기존 프로젝트에서는 에이전트에 `Initialize DOX tree for this project now.`라고 지시하면 하위 AGENTS.md 파일과 인덱스를 생성한다.

전제와 한계

AGENTS.md를 지원하는 에이전트에서 동작하며 Codex, Claude Code, OpenCode 등이 해당한다. 규칙 준수는 에이전트의 지침 수행에 의존하므로 강제 검증이나 린트 수단은 제공하지 않는다. 문서 트리 생성·갱신 범위도 에이전트 판단에 맡겨지며, 별도 설치·의존성·런타임은 요구하지 않는다.

유사 스킬