mentivenus/AGENTS.md

AGENTS

이것은 지식 vault입니다. 새 정보를 처리할 때:

• 기존 파일 먼저 확인, 중복 생성 금지
• 관련 개념에 링크 추가
• 원자적 노트: 파일당 하나의 개념
• frontmatter 필수 포함:
  • 공개 가치 있으면: is_public: true
  • 미완성이면: draft: true
  • tags: 관련 개념 2~3개
  • aliases: 이전 제목·약어·번역명·실제로 검색할 대체 제목이 있을 때만 0~3개
• tags와 aliases:
  • 제품명·기술명·약어 태그는 공식 영문 소문자, 일반 개념 태그는 한국어 사용
  • 동일 개념의 한글·영문 태그를 중복 사용하지 않음
  • 기존 태그를 먼저 재사용하고 일회성 세부 키워드는 본문 검색에 맡김
  • 노트 이름을 변경하면 이전 제목을 aliases에 보존
  • 넓은 주제는 tags, 구체적인 노트 관계는 링크로 표현
• Obsidian 노트 본문 형식:
  • 파일명과 Obsidian 인라인 제목을 문서 제목으로 사용하고 본문 H1은 넣지 않음
  • frontmatter 종료 구분자 --- 바로 다음 줄에서 본문을 시작하며 빈 줄을 넣지 않음
• 문서 작업 명령:
  • 사용자가 독립된 명령으로 doc 또는 “문서 작업해줘”라고 하면 언급·첨부한 노트를 문서 작업 대상으로 처리
  • 원문 의도를 보존하면서 오타·구조·frontmatter·태그·관련 링크를 보완
  • Inbox 노트는 작업 후 10_Processing으로 이동하고, 다른 폴더의 노트는 별도 지시가 없으면 제자리에서 수정
  • 외부 조사, 공개, 대규모 분리와 병합은 사용자가 명시적으로 요청한 경우에만 수행
• Git 작업:
  • 일반 문서 작업 후 수동 커밋하지 않고 Obsidian Git의 주기적 자동 백업에 맡김
  • 사용자가 명시적으로 요청한 경우에만 수동 커밋
• 노트 이동과 이름 변경:
  • 실행 중인 Obsidian 앱의 공식 CLI를 사용하여 내부 링크 자동 갱신 설정을 따름
  • CLI 호출은 필요하면 승인된 권한으로 실행
  • 이동·변경 후 backlinks와 unresolved links를 확인
  • CLI를 사용할 수 없을 때만 참조 링크를 검색해 직접 갱신