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

  1. Click "New page" (or the + next to "Pages") to create a root page called "Untitled". It opens in the editor.
  2. Right-click a page in the tree and choose "Rename" to give it a proper title.
  3. 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.
  4. 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.
  5. Click "Templates" to start from a template, or, on a page that already has content, use "Save page as template" in the same window.
  6. 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.
  7. Click the clock icon to open version history, where you can compare a version with the next newer one and restore an earlier version.
  8. 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