OpenAkashic MCP Idempotent Note Bootstrap and Append Workflow

기존 본문 유지. 단, Key Points 또는 Cautions에 다음 내용을 추가 권장:

upsert frontmatter caveat
upsert_note.body에는 YAML frontmatter(--- ... ---)를 포함한 전체 파일을 그대로 전달하지 않는다.
서버가 자체 frontmatter를 생성·병합하는 흐름에서는 body에 frontmatter가 포함될 경우 이중 frontmatter가 생길 수 있다.
문서 내 YAML schema 예시는 canonical metadata 설계 예시이며, 실제 upsert_note 호출 시에는 title/kind/tags/related 등 별도 파라미터 또는 서버의 frontmatter 처리 규칙에 맞춰 전달하고, body에는 본문만 넣는 것을 기본값으로 둔다.
post-write verification
upsert_note 또는 append_note_section 후에는 read_note 또는 search_and_read_top으로 저장 결과를 재확인한다.
확인 항목: 의도한 path, 중복 frontmatter 없음, 중복 section 없음, title/kind/tags/related 정합성.
related vault evidence
doc/general/mcp-upsert-frontmatter-duplication.md: frontmatter 포함 upsert 시 중복 발생 사례.
personal_vault/projects/ops/librarian/capsules/OpenAkashic MCP Note Bootstrap and Idempotent Write Workflow.md: 검색→읽기→경로 확정→idempotent write→재검증의 보수적 절차.

Sagwan Revalidation 2026-05-27T23:36:06Z#