notion-knowledge-capture · diff
git:20251219.3b1b766 to git:20251219.136d58a
49 added, 7 removed. Audit A to A.
What this update changes in the checks
No check changed: every fixed check gives the same answer before and after this update.
A tripped check is a label, not a verdict: read the matched text and the lines below. This week's updates that newly trip a check.
---
name: notion-knowledge-capture
- description: Capture conversations and discussions into structured Notion pages; use when asked to save, document, or capture knowledge to Notion wiki or database.
+ description: Capture conversations and decisions into structured Notion pages; use when turning chats/notes into wiki entries, how-tos, decisions, or FAQs with proper linking.
metadata:
- short-description: Capture knowledge into Notion pages
+ short-description: Capture conversations into structured Notion pages
---
# Knowledge Capture
- - Extract key information from conversation context
- - Structure into appropriate format (concept, how-to, decision record, FAQ)
- - Save to Notion using `Notion:notion-create-pages`
- - Link from hub pages to ensure discoverability
- - See reference/ for database schemas and content type templates
+ Convert conversations and notes into structured, linkable Notion pages for easy reuse.
+
+ ## Quick start
+ 1) Clarify what to capture (decision, how-to, FAQ, learning, documentation) and target audience.
+ 2) Identify the right database/template in `reference/` (team wiki, how-to, FAQ, decision log, learning, documentation).
+ 3) Pull any prior context from Notion with `Notion:notion-search` → `Notion:notion-fetch` (existing pages to update/link).
+ 4) Draft the page with `Notion:notion-create-pages` using the database’s schema; include summary, context, source links, and tags/owners.
+ 5) Link from hub pages and related records; update status/owners with `Notion:notion-update-page` as the source evolves.
+
+ ## Workflow
+ ### 0) If any MCP call fails because Notion MCP is not connected, pause and set it up:
+ 1. Add the Notion MCP:
+ - `codex mcp add notion --url https://mcp.notion.com/mcp`
+ 2. Enable remote MCP client:
+ - Set `[features].rmcp_client = true` in `config.toml` **or** run `codex --enable rmcp_client`
+ 3. Log in with OAuth:
+ - `codex mcp login notion`
+
+ After successful login, the user will have to restart codex. You should finish your answer and tell them so when they try again they can continue with Step 1.
+
+ ### 1) Define the capture
+ - Ask purpose, audience, freshness, and whether this is new or an update.
+ - Determine content type: decision, how-to, FAQ, concept/wiki entry, learning/note, documentation page.
+
+ ### 2) Locate destination
+ - Pick the correct database using `reference/*-database.md` guides; confirm required properties (title, tags, owner, status, date, relations).
+ - If multiple candidate databases, ask the user which to use; otherwise, create in the primary wiki/documentation DB.
+
+ ### 3) Extract and structure
+ - Extract facts, decisions, actions, and rationale from the conversation.
+ - For decisions, record alternatives, rationale, and outcomes.
+ - For how-tos/docs, capture steps, pre-reqs, links to assets/code, and edge cases.
+ - For FAQs, phrase as Q&A with concise answers and links to deeper docs.
+
+ ### 4) Create/update in Notion
+ - Use `Notion:notion-create-pages` with the correct `data_source_id`; set properties (title, tags, owner, status, dates, relations).
+ - Use templates in `reference/` to structure content (section headers, checklists).
+ - If updating an existing page, fetch then edit via `Notion:notion-update-page`.
+
+ ### 5) Link and surface
+ - Add relations/backlinks to hub pages, related specs/docs, and teams.
+ - Add a short summary/changelog for future readers.
+ - If follow-up tasks exist, create tasks in the relevant database and link them.
+
+ ## References and examples
+ - `reference/` — database schemas and templates (e.g., `team-wiki-database.md`, `how-to-guide-database.md`, `faq-database.md`, `decision-log-database.md`, `documentation-database.md`, `learning-database.md`, `database-best-practices.md`).
+ - `examples/` — capture patterns in practice (e.g., `decision-capture.md`, `how-to-guide.md`, `conversation-to-faq.md`).