POPULAR-PROMPTS-AND-STARTERS.md markdown
193 lines 9.9 KB
Raw
sha256:65ccb454656ea5acdea0a10e559b78bcde1eb6ff753ecc2911bc99d1c3d7cadd feat(calendar): enforce agent context tiers in retrieval AP… Human minor ⚠ breaking 1 day ago

Popular prompts, copy-paste starters, and workflows

What this page is: A single place to find MCP prompt names (for clients that support them), copy-paste text you can use in any chat (Cursor, Copilot, web LLMs, etc.), and CLI one-liners—plus a short plain-English take on wiki-style linking, synthesis pages, and surfacing disagreements in your notes.

Where the short version lives in the app: Hub → How to use → Knowledge & agents (summary + link here).


1. Four ways assistants connect to your vault

Kind What it is You use it when
MCP tools Actions: search, list notes, inspect a note outline or tree, read a note, write, propose, memory tools, import, index, etc. Your IDE or agent app has Knowtation MCP connected (AGENT-INTEGRATION.md).
MCP prompts Named recipes the client calls: they pull live vault (or memory) data and build a full message list. Same as above; the client offers a prompt picker (names below).
MCP resources Read-only URIs: e.g. knowledge graph, prime/bootstrap, config hints—not a “chat template.” Agent calls read resource for structure, not for a user-written instruction.
Copy-paste starters Plain text you put in the chat yourself. Works without MCP (any LLM). You want a quick behavior without wiring tools, or the tool is CLI-only on your machine.

Skill packs (e.g. under .cursor/skills/packs/) are longer playbooks—how to behave in a domain, which searches to run, which MCP prompts to prefer. They are not a fourth transport; they guide the same three layers above.


2. Wiki-style expansion, synthesis pages, research (plain language)

  • Wiki-style expansion — You link notes with [[Another note]] (Obsidian-style). The system can list backlinks (who links here) and show graph relationships. You are building a web of ideas in your vault, not one long file.
  • Synthesis pages — A short “current story” note: what you believe so far on a topic, with links to source clips and related pages. Raw material stays in source or inbox notes; synthesis is rewritten as you learn, so you are not re-deriving everything from scratch every time.
  • Research — Not a separate product. It is a project (project: in frontmatter or a projects/<name>/ folder) plus habits: import → search → relate → optional synthesis note. Templates and skill packs (e.g. research-oriented) make that easier; they are optional.
  • Surfacing disagreements — If two sources conflict, you can (a) log both and add a line in a synthesis or sidecar note “Tension: A says …, B says …”, (b) use memory consolidation with the optional Discover pass (works on memory topic summaries—see MEMORY-CONSOLIDATION-GUIDE.md), or (c) paste the contradiction audit starter below and point the model at a folder of notes.

3. Built-in MCP prompt IDs (server-side; data-aware)

After MCP connects, these prompt names are what clients list (some may be role-gated on hosted—see AGENT-INTEGRATION.md § Hosted MCP).

Prompt ID What it does (short)
daily-brief Notes since a date; themes and open threads.
search-and-synthesize Semantic search, embeds top notes; asks for synthesis + gaps.
project-summary Executive-style summary for a project slug.
write-from-capture Turn pasted raw text into a proper note (optional capture template).
temporal-summary What happened between two dates; optional topic filter.
extract-entities JSON people/places/decisions/goals from notes in scope.
meeting-notes Transcript → structured meeting note + suggested path.
knowledge-gap Search hits → what is missing, what to capture next.
causal-chain Notes sharing causal_chain_id in order.
content-plan Content calendar / plan from project notes.
memory-context Recent memory events (skeptical: verify paths).
memory-informed-search Search + recent search memory → what is new.
resume-session Pick up from session summaries + recent activity.

Implementation: mcp/prompts/register.mjs.


4. Copy-paste starters (work in any LLM; adapt paths)

When you do not have MCP, combine these with manual steps: you search in the Hub or run knowtation search in a terminal, paste snippets into chat, then save the result yourself—or use proposals if your agent is wired to the Hub.

Check a long note before reading it all

Use this when search finds a promising long note and you want structure before spending tokens on the full body.

First inspect the note headings with `get-note-outline` / `get_note_outline`.
Use `get-document-tree` / `get_document_tree` when parent-child heading hierarchy matters.
Use the heading list to decide whether the note is relevant.
Only fetch the full note body if the outline confirms it is needed.
Do not summarize or infer from headings alone; treat the outline or tree as navigation.

Wiki + synthesis (first-time layout)

I'm building a personal wiki in my Knowtation vault. Conventions:
- Raw clips and PDFs live under `projects/MYPROJECT/sources/`.
- Short "what I think so far" lives under `projects/MYPROJECT/synthesis/` with links to sources using [[note name]].
- When I add a source, suggest updates to the relevant synthesis file without deleting my raw notes.
Start by asking me the project slug and one topic to draft a synthesis outline.

Knowledge gap (after you paste search results or note titles)

Here are my vault search results (titles/paths) for TOPIC:
[paste list]

What is missing from my note set? What should I read or capture next? List 3 concrete next notes to create.

Contradiction or tension pass

I have several notes in PROJECT/FOLDER that may disagree. I will paste excerpts or paths.
1) List claims that cannot all be true at once.
2) For each, quote or cite the note path.
3) Do not resolve into a single answer—show the tension. Suggest one note title for a "tensions" or "open questions" file.

Daily stand-up from notes

Summarize my focus for today from these note titles and one-line descriptions (paste from list-notes or Hub).
Group: urgent, waiting on others, deep work. If something looks stale, say so.

Meeting → actions (no MCP)

Turn this meeting transcript into:
- Decisions
- Action items (owner, due if known)
- Open questions
I'll save it as a markdown note with YAML frontmatter (title, date, project, tags).
[transcript]

Resume where I left off (when memory is in use on self-hosted / MCP)

Use MCP prompt resume-session if connected. Otherwise:

Here are my last few notes (titles and dates) [paste]. Infer what I was working on and suggest 3 next steps. Ask one clarifying question.

Import and index reminder (for assistants helping setup)

After I import markdown into the vault, remind me to run semantic indexing (`npm run index` or Hub Re-index) so search and agents see new files.

5. High-value CLI one-liners

Run from a machine with config/local.yaml or KNOWTATION_VAULT_PATH set. Shapes: RETRIEVAL-AND-CLI-REFERENCE.md.

# Meaning search, tight limit, JSON for agents
knowtation search "your question" --project myapp --limit 5 --json

# Keyword (literal) when you need exact terms
knowtation search "exact phrase" --keyword --project myapp --limit 20 --json

# List recent notes
knowtation list-notes --project myapp --since 2026-01-01 --json

# Propose a change (needs Hub token for remote)
export KNOWTATION_HUB_URL=https://your-hub.example.com
export KNOWTATION_HUB_TOKEN=…
knowtation propose "inbox/idea.md" --hub "$KNOWTATION_HUB_URL" --body "..." --json
# One-shot memory consolidation (self-hosted; optional passes)
knowtation memory consolidate --json

Doctor check: knowtation doctor (vault path, optional Hub reachability).


6. More “power user” ideas (MCP or CLI)

Goal How
Neighbor notes (semantic) Tool relate with a path (phase-c tools).
Backlinks to this note Tool backlinks — who links to a path.
Graph overview Resource / graph (PARITY-MATRIX-HOSTED.md for hosted).
Inbox capture from automation POST /api/v1/capture or CLI capture; AGENT-INTEGRATION.md.
Enrich frontmatter (tags/title suggestion) Tool enrich (optional apply: true).
Proposals workflow Tools propose / evaluate_proposal / Hub UI Suggested tab.
Transcription (self-hosted) knowtation import audio … with your key — IMPORT-SOURCES.md.

7. Hosted vs self-hosted (prompts and tools)

  • Hosted Hub: connect MCP to your gateway with JWT; prompts list may be scoped by role; some tools (e.g. import with file_base64) are hosted-friendly. See PARITY-MATRIX-HOSTED.md.
  • Self-hosted: stdio knowtation mcp with local vault; full tool surface; knowtation://prime for bootstrap.

8. See also


This file is the canonical, versioned “long form.” The Hub’s How to use modal points here for the full set.

File History 2 commits
sha256:65ccb454656ea5acdea0a10e559b78bcde1eb6ff753ecc2911bc99d1c3d7cadd feat(calendar): enforce agent context tiers in retrieval AP… Human minor 1 day ago
sha256:9103f98c89257ed2b01c237cea895dabb3e85ea337dccb1161c175e4422355b6 docs: accept Calendar Events v0 spec with Phase 0 security … Human 1 day ago