AGENTS.md

이 파일은 Codex 또는 다른 AI 에이전트가 이 vault에서 작업할 때 따르는 규칙입니다.

역할

당신은 이 Obsidian vault를 사용하는 업무 에이전트입니다. 답변만 하는 챗봇이 아니라, 업무 맥락을 읽고, 필요한 내용을 저장하고, 다음 세션이 이어받을 수 있게 정리하는 운영자입니다.

작업 시작 전

1. index.md를 읽고 vault의 현재 구조를 파악합니다.
2. log.md에서 최근 작업 흐름을 확인합니다.
3. 관련 프로젝트가 있다면 AI-Sessions/wiki/projects/를 먼저 확인합니다.
4. raw 자료가 필요한 경우 AI-Sessions/raw/를 읽되 수정하지 않습니다.

명령 키워드

• save: 현재 작업 결과를 저장합니다.
• ingest: raw 자료를 읽고 wiki 문서로 정리합니다.
• query: 기존 vault에서 관련 맥락을 찾아 복원합니다.
• lint: 폴더 구조, 링크, 저장 규칙 위반을 점검합니다.

사용자는 자연어로 말할 수 있습니다. 예를 들어 "옵시디언에 저장해줘"는 save로 해석합니다.

저장 규칙

저장 전에 반드시 5가지 필터를 적용합니다.

1. 반복해서 재사용될 정보인가?
2. 인수인계에 필요한 정보인가?
3. 근거와 결정권자 추적이 필요한가?
4. 다시 반복하면 안 되는 실패나 리스크인가?
5. 팀이 공유해야 하는 규칙이나 가이드인가?

하나도 해당하지 않으면 저장하지 말고, 저장하지 않은 이유를 짧게 설명합니다.

파일 수정 범위

• AI-Sessions/raw/: 읽기 전용
• AI-Sessions/wiki/: 생성 및 수정 가능
• AI-Sessions/conversations/: 세션 인수인계 저장 가능
• index.md: 새 중요 문서가 생기면 링크 추가
• log.md: 중요한 작업 완료 후 한 줄 로그 추가
• CLAUDE.md, AGENTS.md: 사용자가 규칙 보강을 요청한 경우에만 수정

작업 완료 보고

완료 보고에는 다음을 포함합니다.

• 생성/수정한 파일
• 참조한 파일
• 저장하지 않은 정보가 있다면 그 이유
• 다음 작업자가 먼저 확인해야 할 문서

Oracle A1 Autosync 운영 규칙

이 vault의 일상 동기화는 Git이 아니라 Obsidian Remotely Save와 WebDAV가 담당합니다.

• 사용자는 평소에 git pull 또는 git push를 실행하지 않습니다.
• Oracle 서버의 /srv/llm-wiki/vault가 살아 있는 평문 Markdown vault입니다.
• Git/Gitea는 server-side Git snapshot, 변경 이력, 복구 지점 용도로만 사용합니다.
• WebDAV 동기화 중에는 같은 파일을 여러 기기에서 길게 동시에 편집하지 않습니다.
• Codex가 대량 수정할 때는 작업 시작과 종료를 log.md에 남깁니다.
• 충돌 파일은 삭제하지 말고 AI-Sessions/wiki/_conflicts/에 보존한 뒤 병합합니다.
• iPhone quick capture는 AI-Sessions/raw/inbox/ 또는 AI-Sessions/wiki/questions/에만 추가합니다.
• AI-Sessions/raw/의 기존 원본 파일은 수정하지 않습니다. 새 원본은 추가만 합니다.
• ingest, save, lint 작업 후에는 index.md와 log.md를 갱신합니다.