Docs / Plan
Knowledge Base
The project's knowledge base: wiki-style pages in a tree, for decisions, notes and reference material.
When to use it
When knowledge should outlive a chat thread, such as decisions, runbooks and meeting notes.
Start here
Click "New page" to start your first page, then add child pages to organise it. Deleting a page moves its child pages up one level.
How to use it
- Click "New page" (or the + next to "Pages") to create a root page called "Untitled". It opens in the editor.
- Right-click a page in the tree and choose "Rename" to give it a proper title.
- To nest a page, hover over its parent in the tree and click the + button, or right-click and choose "Add child page". Use the arrow to expand or collapse a branch.
- Write in the editor. The page saves itself, and the top bar shows "Saving…" and then "Saved". Type / to open a menu of callouts, status badges, expandable sections, a table of contents and embeds.
- Click "Templates" to start from a template, or, on a page that already has content, use "Save page as template" in the same window.
- Click the "Draft" or "Published" button in the top bar to change the page's state. The circle-i icon opens page info with status, "Last Reviewed" and "Mark as reviewed", linked features and backlinks.
- Click the clock icon to open version history, where you can compare a version with the next newer one and restore an earlier version.
- Click "Gaps" to see missing or stale documentation, use "Ask Wiki" at the bottom right to ask a question about the knowledge base, and use "Confluence" to export the page.
Good to know
- Using a template replaces the page's current content and title.
- A version is snapshotted when you save an edit, at most once every 30 minutes. The 50 most recent versions are kept.
- The "Gaps" panel flags stale pages, empty pages, missing PRD overviews, missing retrospectives and undocumented features, with an action button for most of them.
- Deleting a page (right-click, then "Delete") does not delete its child pages. The confirmation says how many will move up to the deleted page's parent, or to the top level.
- Pasting, on its own, a link to a GitHub pull request or issue, a Figma file, a Loom share, a Linear issue or a Notion page turns it into a link card.
Related
Last updated 6 October 2026