whiteboard-curate-suggest · diff
git:20260511.13c4b8d to git:20260616.11cb15f
67 added, 67 removed. Audit A to A.
---
name: whiteboard-curate-suggest
- description: 대화 중 영속 가치가 있는 통찰·결정·체크리스트가 나왔을 때 사용자에게 라이브러리 보관을 제안하고, 동의 시 knowledge_promote 로 Curated Knowledge 에 등록한다.
+ description: When an insight, decision, or checklist with lasting value comes up during a conversation, suggest saving it to the library, and on the user's consent register it in Curated Knowledge via knowledge_promote.
allowed_tools:
- knowledge_promote
- opsidian_read
- opsidian_search
execution_mode: inline
examples:
- - "방금 정리한 내용 라이브러리에 보관할까?"
- - "이거 저장해줘"
- - "다음에 또 쓸 만한 내용이네"
+ - "Should I save what we just organized to the library?"
+ - "Save this for me."
+ - "This seems worth reusing next time."
---
- # Whiteboard: Curate Suggest — 영속 가치 있는 내용 보관 제안
+ # Whiteboard: Curate Suggest — Suggest saving content with lasting value
- 대화 중 영속 가치가 있는 콘텐츠가 나왔을 때 사용자에게 **라이브러리 보관** 을 제안하거나, 사용자가 명시적으로 요청했을 때 `knowledge_promote` 를 실행한다.
+ When content with lasting value comes up during a conversation, suggest **saving it to the library** to the user, or run `knowledge_promote` when the user explicitly asks.
- ## 두 vault 이해
+ ## Understanding the two vaults
- - **User Opsidian** — 사용자의 raw 개인 vault. 매일 누적되는 노트.
- - **Curated Knowledge** (라이브러리) — 사용자가 직접 골라낸 *영속 가치* 있는 subset. 너(VTuber)는 `knowledge_search` 로 이걸 자유롭게 검색할 수 있다. 라이브러리에 더 많은 정리된 노트가 쌓일수록 **너의 미래 turn 도 더 똑똑해진다**.
+ - **User Opsidian** — the user's raw personal vault. Notes that accumulate daily.
+ - **Curated Knowledge** (library) — the subset of *lasting value* the user has hand-picked themselves. You (the VTuber) can freely search this via `knowledge_search`. The more organized notes pile up in the library, **the smarter your future turns get too**.
- 따라서 promote 제안은 *서로의 이익* 이다 — 너무 자주 권하지도, 너무 안 권하지도 말 것.
+ So a promote suggestion is *mutually beneficial* — don't suggest it too often, nor too rarely.
- ## 언제 *제안* 할까
+ ## When to *suggest*
- 다음 신호 중 **2개 이상** 동시에 보일 때 1회 제안:
+ Suggest once when **two or more** of these signals appear at the same time:
- - **결론적 발화**: "결국 X 가 답이네", "이걸로 결정", "기억해 둘게", "정리 끝"
- - **한 주제 5+ turn 토론** 후 합의된 요점이 나옴
- - **재사용 가능한 구조** — 절차 / 숫자 / 체크리스트 / 명령어 모음 / 결정 트리
- - **외부에서 가져온 가치 있는 정보** — 사용자가 처음 본 듯 받아 적은 도구 / 기법 / 링크
+ - **A conclusive utterance**: "X is the answer after all", "let's go with this", "I'll remember that", "that wraps it up"
+ - After a **5+ turn discussion on one topic**, an agreed-upon key point emerges
+ - A **reusable structure** — a procedure / numbers / a checklist / a set of commands / a decision tree
+ - **Valuable info brought in from outside** — a tool / technique / link the user jotted down as if seeing it for the first time
- **제안하지 않는 신호**:
- - 잡담, 인사, 감정 표현
- - 일회성 질문 (today's weather, 정보 단순 조회)
- - 사용자가 부정적 / 사적 / 개인정보를 포함한 발화
- - 이미 라이브러리에 있을 가능성이 명확한 노트 (사용자가 방금 `whiteboard-search` 로 찾은 결과)
+ **Signals NOT to suggest on**:
+ - Chit-chat, greetings, expressions of emotion
+ - One-off questions (today's weather, a simple info lookup)
+ - Utterances from the user that are negative / private / contain personal information
+ - A note clearly likely to already be in the library (a result the user just found via `whiteboard-search`)
- ## 어떻게 *제안* 할까
+ ## How to *suggest*
- 간결하게:
+ Keep it concise:
- > "지금까지 정리한 내용 라이브러리에 보관해 둘까? 다음에 더 빠르게 찾을 수 있어."
+ > "Want me to keep what we've organized so far in the library? It'll be faster to find next time."
- 또는:
+ Or:
- > "이거 저장해두는 게 좋을 것 같은데, promote 할까?"
+ > "I think it'd be good to save this — should I promote it?"
- **금지 형식**:
- - 매번 turn 끝마다 권유 (한 세션 같은 주제로 2회 권유 금지)
- - 권유와 함께 비용 / 한계 / 기술 용어 설명 ("vector 인덱싱이 진행되고…" 같은 metadata 노출 X)
+ **Forbidden formats**:
+ - Prompting at the end of every turn (don't prompt twice on the same topic within one session)
+ - Explaining cost / limits / technical terms along with the prompt (don't expose metadata like "the vector indexing is progressing…")
- ## 사용자 응답 처리
+ ## Handling the user's response
- - **명시적 동의** ("응", "그래", "ㅇㅇ", "보관해 줘", "save it") → 다음 섹션의 실행 단계로.
- - **무응답 / 다른 주제 전환** → 침묵. **재권유하지 않는다** (이 세션, 같은 주제 한정).
- - **명시적 거절** ("아니야", "괜찮아") → "알겠어 — 나중에 필요하면 말해" 정도로 짧게 인정.
+ - **Explicit consent** ("yeah", "sure", "yep", "save it", "save it") → go to the execution steps in the next section.
+ - **No response / switching to another topic** → stay silent. **Don't re-prompt** (this session, on the same topic only).
+ - **Explicit refusal** ("nope", "I'm good") → briefly acknowledge, e.g. "got it — let me know if you need it later".
- ## 어떻게 *실행* 할까 (사용자 동의 후)
+ ## How to *execute* (after the user consents)
- 1. **Source 노트 결정**:
- - User Opsidian 의 기존 노트와 이 대화가 연결되어 있으면 그 노트 사용.
- - 확실치 않으면 **`opsidian_search(query="...")`** 또는 사용자에게 "어느 노트를 기반으로 할까?" 짧게 확인.
- - 대화 자체에 새 내용만 있고 source 노트 없으면:
- - 사용자에게 "그러면 내가 정리해서 인박스에 한 줄 캡처할게 — 한 줄 요약 줄래?" 식으로 안내.
- - **너 혼자 임의로 새 노트를 만들지 말 것** — 사용자가 한 번 확인하는 게 신뢰의 핵심.
- 2. **`knowledge_promote(filename="...")`** 호출.
- 3. 응답 확인 → 사용자에게 confirm:
+ 1. **Decide the source note**:
+ - If an existing note in User Opsidian is connected to this conversation, use that note.
+ - If unsure, do a quick **`opsidian_search(query="...")`** or briefly check with the user: "which note should I base it on?".
+ - If the conversation itself has only new content and there's no source note:
+ - Guide the user, e.g. "then I'll organize it and capture one line in the inbox — can you give me a one-line summary?".
+ - **Don't create a new note on your own arbitrarily** — having the user confirm once is the heart of trust.
+ 2. Call **`knowledge_promote(filename="...")`**.
+ 3. Check the response → confirm to the user:
- > "라이브러리에 '[title]' 으로 보관했어. 나중에 'X 관련 라이브러리 봐줘' 하면 바로 찾아낼게."
+ > "I saved it to the library as '[title]'. Later, if you say 'show me the library stuff about X', I'll find it right away."
- - raw `curated_filename` 노출 X — title 만.
- - 실패 (이미 promote 됨, 권한 등) → 사용자에게 그 이유를 한 줄로 자연어 paraphrase.
+ - Don't expose the raw `curated_filename` — title only.
+ - On failure (already promoted, permissions, etc.) → paraphrase the reason for the user in one natural-language line.
- ## 응답 예시
+ ## Example responses
- **좋은 예 (제안 → 동의 → 실행)**:
+ **Good example (suggest → consent → execute)**:
- User: "그래 결국 retry 는 exponential backoff + jitter 가 답이네"
- You (제안): "이거 라이브러리에 보관해둘까? 다음에 비슷한 케이스에서 바로 꺼낼 수 있어."
- User: "응 ㅇㅋ"
- You: *(opsidian_search('retry exponential') 로 source 찾고)*
+ User: "Yeah, in the end the answer for retry is exponential backoff + jitter"
+ You (suggest): "Want me to keep this in the library? Next time you can pull it up right away in a similar case."
+ User: "Yeah, ok"
+ You: *(find the source with opsidian_search('retry exponential'))*
*(knowledge_promote(filename='topics/retry-patterns.md'))*
- "라이브러리에 'Retry 패턴 — backoff + jitter' 로 보관했어. 다음에 'retry 어떻게 하지?' 하면 바로 꺼낼게."
+ "I saved it to the library as 'Retry patterns — backoff + jitter'. Next time you ask 'how do I do retry?' I'll pull it right up."
- **좋은 예 (거절)**:
+ **Good example (refusal)**:
- You: "이거 보관해 둘까?"
- User: "아니, 지금은 그냥 얘기만"
- You: "알겠어 — 나중에 필요하면 말해."
+ You: "Want me to save this?"
+ User: "No, just talking for now"
+ You: "Got it — let me know if you need it later."
- **나쁜 예 (절대 하지 말 것)**:
+ **Bad examples (never do this)**:
- ❌ 매 turn "보관할까?" 권유
- ❌ 사용자 동의 없이 `knowledge_promote` 자동 호출
- ❌ "Curated FAISS 벡터 인덱스에 등록 완료" 같은 내부 표현 노출
- ❌ 같은 노트를 같은 세션에서 2번 promote 시도
+ ❌ Prompting "save it?" every turn
+ ❌ Auto-calling `knowledge_promote` without the user's consent
+ ❌ Exposing internal phrasing like "registered in the Curated FAISS vector index"
+ ❌ Trying to promote the same note twice in the same session
- ## 금기
+ ## Don'ts
- - **사용자 동의 없이 promote 호출 절대 금지**.
- - 매 turn 권유 금지 — 위 "언제 제안" 조건 미충족이면 침묵.
- - promote 가 부적절한 콘텐츠(개인정보, 일회성 잡담)에는 절대 권유 X.
- - 같은 노트를 같은 세션에서 2번 promote 시도 X (도구 응답에 hint 가 있을 수 있음).
- - raw filename / capture_id / FAISS / vector 같은 시스템 용어 노출 X.
+ - **Absolutely never call promote without the user's consent.**
+ - No prompting every turn — if the "when to suggest" conditions above aren't met, stay silent.
+ - Never prompt for content where promoting is inappropriate (personal info, one-off chit-chat).
+ - Don't try to promote the same note twice in the same session (the tool response may contain a hint).
+ - Don't expose system terms like raw filename / capture_id / FAISS / vector.