My Vaults

my-vaults (ob-docs)

standalone ob-docs (https://vault.my-agentic-ai.click) vault를 API로 읽고 씁니다.
노트는 .md가 Source of Truth입니다. 임의 HTTP를 새로 짜지 말고 아래 스크립트를 실행하세요.

계정(USER_ID / email)마다 S3·디스크가 vault/{userId}/…로 분리됩니다.
스크립트가 보내는 userId의 vault만 보이며, 노트 경로는 항상 그 계정 vault 기준 상대경로입니다 (예: Meeting/Note.md — path에 email을 넣지 마세요).

When to Use

• vault / ob-docs / 내 노트 / 위키 노트 조회
• 노트 검색, 파일 트리, 백링크·그래프 확인
• 새 노트 작성, 기존 노트 수정·이어쓰기·이름변경·삭제

Script Location

application working directory 기준 전체 경로를 사용하세요.

IMPORTANT: scripts/...로 줄이지 말고 위 전체 경로를 사용하세요.

Critical Rules

1. 반드시 스크립트로 조회·수정하세요. curl로 ad-hoc API를 새로 작성하지 마세요.
2. 경로는 vault 상대경로입니다. 예: AI/Ontology.md, Meeting/Weekly-Sync.md
3. 덮어쓰기 전에 read로 현재 내용을 확인하세요. 부분 추가는 append를 우선 사용하세요.
4. 출력은 JSON입니다. 사용자에게는 한국어로 요약하고, 본문이 길면 핵심만 인용하세요.
5. 인증은 스크립트가 USER_ID/CURRENT_USER_ID와 vault-agent-token으로 처리합니다. 쿠키를 수동으로 만들지 마세요.
6. 노트 본문 형식: YAML frontmatter(--- … title/date/tags/aliases/status … ---)를 넣지 마세요. 새 노트·덮어쓰기는 상단을 # 제목 한 줄로 시작하고 바로 본문을 이어서 쓰세요.
7. 새 노트는 vault 루트에 두지 마세요. 주제 폴더 아래(Category/Note.md)에만 저장합니다. 아래 Folder Organization을 따르세요.
8. 결과는 가능한 하나의 마크다운에 모으세요. 같은 주제·같은 작업의 산출물을 작은 .md 여러 개로 쪼개지 마세요. 섹션(##/###)으로 구조화하고, 분량이 많으면 제목 바로 아래에 목차(TOC) 를 넣으세요. 사용자가 파일 분리를 명시하거나 기존 노트에 이어 쓰는 경우만 예외입니다.

# Claude Tag

## 목차
- [개요](#개요)
- [세부](#세부)

## 개요

본문…

## 세부

본문…

Folder Organization

새 노트 작성 시 반드시 카테고리 폴더에 넣습니다. 루트에 Something.md를 만들지 마세요.

절차

1. tree 또는 list로 기존 폴더를 확인합니다.
2. 노트 주제에 맞는 폴더가 이미 있으면 그 폴더를 재사용합니다. (대소문자·이름 변형이 비슷하면 기존 폴더 우선)
3. 없으면 mkdir로 새 카테고리 폴더를 만든 뒤 그 안에 노트를 저장합니다.
4. 경로 형식: <Category>/<NoteTitle>.md (예: Meeting/Sprint-Review.md)

카테고리 예시

노트 내용에 맞게 선택·생성하세요. 대표 예시는 다음과 같습니다.

위 목록에 없으면 짧은 PascalCase/영문 폴더명을 새로 만드세요 (예: Legal, Health, Travel). 한 노트에 주제가 겹치면 가장 구체적인 하나만 고릅니다.

금지 / 권장

• ❌ Draft.md, Note.md처럼 vault 루트에 직접 저장
• ❌ 매번 00-Inbox에만 쌓기 (사용자가 명시하지 않는 한)
• ❌ 같은 주제 결과를 Overview.md / Details.md / Summary.md처럼 작은 파일 여러 개로 쪼개기
• ✅ 기존 AI/가 있으면 AI/New-Topic.md
• ✅ 없으면 mkdir Meeting 후 Meeting/Standup-2026-03-17.md
• ✅ 긴 노트는 하나의 .md + ## 섹션 + (분량 많으면) 목차

Quick Start

# 연결 확인 (기본 URL: https://vault.my-agentic-ai.click)
python skills/my-vaults/scripts/read_vault.py health

# 노트 목록
python skills/my-vaults/scripts/read_vault.py list
python skills/my-vaults/scripts/read_vault.py list --prefix Productivity

# 트리 (새 노트 전 폴더 확인용)
python skills/my-vaults/scripts/read_vault.py tree

# 읽기
python skills/my-vaults/scripts/read_vault.py read Productivity/Convention.md
python skills/my-vaults/scripts/read_vault.py read Productivity/Convention.md --raw

# 검색
python skills/my-vaults/scripts/read_vault.py search "온톨로지"

# 그래프 / 백링크
python skills/my-vaults/scripts/read_vault.py graph
python skills/my-vaults/scripts/read_vault.py backlinks Productivity/Convention.md

쓰기 (본문은 항상 # 제목으로 시작 — frontmatter 금지. 루트 저장 금지):

# 새 노트 전: 기존 폴더 확인
python skills/my-vaults/scripts/read_vault.py tree

# 폴더가 없으면 생성 후 저장
python skills/my-vaults/scripts/write_vault.py mkdir Meeting
python skills/my-vaults/scripts/write_vault.py write Meeting/Sprint-Review.md --content "# Sprint Review\n\n본문"

# 기존 폴더가 있으면 그대로 사용
python skills/my-vaults/scripts/write_vault.py write AI/Prompt-Patterns.md --content "# Prompt Patterns\n\n본문"

# 로컬 파일 업로드
python skills/my-vaults/scripts/write_vault.py write Research/Report.md --file "$ARTIFACTS_DIR/report.md"

# 이어쓰기 (stdin)
printf '\n## Update\n- item\n' | python skills/my-vaults/scripts/write_vault.py append Agent/Runtime-Log.md --stdin

# 이동 / 삭제
python skills/my-vaults/scripts/write_vault.py rename Meeting/Draft.md Productivity/Draft.md
python skills/my-vaults/scripts/write_vault.py delete Meeting/Draft.md

Agent usage

import subprocess

READ = "skills/my-vaults/scripts/read_vault.py"
WRITE = "skills/my-vaults/scripts/write_vault.py"

# 새 노트 전 폴더 확인
r = subprocess.run(["python", READ, "tree"], capture_output=True, text=True)
print(r.stdout)

r = subprocess.run(["python", READ, "search", "온톨로지"], capture_output=True, text=True)
print(r.stdout)

# 카테고리 폴더 아래만 쓰기 (루트 금지)
r = subprocess.run(
    ["python", WRITE, "mkdir", "Agent"],
    capture_output=True, text=True,
)
r = subprocess.run(
    ["python", WRITE, "append", "Agent/Runtime-Log.md", "--content", "- done\\n"],
    capture_output=True, text=True,
)
print(r.stdout)

Subcommands

read_vault.py

write_vault.py

공통 옵션: --user-id (기본은 환경변수 USER_ID / CURRENT_USER_ID)

API는 ob-docs 사이트 루트의 /api/... 입니다 (구 /vault/api/... 아님).

Environment

로컬 ob-docs:

export OB_DOCS_URL=http://127.0.0.1:8502
export USER_ID='kyopark2014@gmail.com'   # 계정별 vault
python skills/my-vaults/scripts/read_vault.py list

config.json에 ob_docs_url을 넣어도 됩니다.

Response tips

• list/search 결과는 path 표로 정리하세요.
• read는 title·tags·backlinks를 함께 보여준 뒤 본문 요약을 하세요.
• 쓰기 성공 시 path와 ok: true만 짧게 확인하면 됩니다.
• 새 노트 작성 시 frontmatter 없이 # 제목 + 본문만 저장하고, 카테고리 폴더 경로(AI/..., Meeting/... 등)를 사용자에게 알려 주세요.
• 사용자가 폴더를 지정하지 않아도 주제에 맞는 폴더를 고르거나 만들고, 기존 폴더가 있으면 재사용하세요.
• 조사·요약·리포트·회의록 등은 한 파일에 섹션으로 모으세요. Part1.md / Part2.md처럼 잘게 나누지 마세요.
• 본문이 길면 (## 섹션이 대략 4개 이상이거나 스크롤이 길 때) # 제목 다음에 ## 목차와 앵커 링크 목록을 넣으세요.

Troubleshooting

Vault auth unavailable / SESSION_SIGNING_KEY not found

AgentCore 런타임은 session-signing-key 읽기가 IAM Deny입니다.
agent-skills/vault-agent-token 또는 ob-docs/vault-agent-token + 런타임 정책 Allow가 필요합니다.
두 시크릿 문자열이 동일해야 ob-docs가 검증에 성공합니다.

Failed to reach ob-docs

OB_DOCS_URL이 https://vault.my-agentic-ai.click (또는 로컬 http://127.0.0.1:8502)인지 확인하세요.
agentic-work CloudFront(cowork…)로 치면 실패합니다.

HTTP 404 on /vault/api/...

구 경로입니다. 이 스킬은 /api/health, /api/files/tree 등 사이트 루트 API만 사용합니다. 스킬을 최신으로 동기화하세요.

HTTP 401 unauthorized

프로덕션: vault-agent-token이 ob-docs·AgentCore 양쪽에 있고 값이 같은지 확인하세요.
로컬: OB_DOCS_URL=http://127.0.0.1:8502 + ob-docs ALLOW_LOCAL_AUTH_BYPASS=1.

빈 tree / File not found

USER_ID가 실제 Google email인지 확인하세요. local-dev는 별도 빈 vault입니다.
노트는 vault/{email}/… 아래에만 있습니다.