Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cubic.dev/llms.txt

Use this file to discover all available pages before exploring further.

Add page context from Notion to make AI reviews understand your requirements, generate accurate PR descriptions, and analyze whether your code meets acceptance criteria.

​
Setup

​
Connect Notion

  1. Navigate to integration settings.
  2. Click Connect on the Notion integration card.
  3. Authorize cubic to access your Notion workspace through the OAuth flow.

​
Configure AI behavior

Toggle these options based on your workflow:
  • Use context when reviewing code — The AI reviewer reads linked Notion pages to check whether code matches page requirements
  • Show linked issue analysis in reviews — Post acceptance criteria assessment in PR review comments. When disabled, page context still improves review quality without appearing publicly. Requires “Use context when reviewing code” to be enabled.
  • Use context when writing PR descriptions — Generate descriptions from linked Notion pages
  • Automatically associate pages — cubic detects Notion page URLs and unique ID codes in your PR and links them without manual intervention

​
How it works

cubic searches across all accessible pages in your connected Notion workspace. It finds pages through two methods:

​
Page URLs

Add a Notion page URL to your PR title, branch name, or description. cubic extracts the page ID and imports the content automatically. Supported URL formats: 
https://www.notion.so/Page-Title-b55c9c91384d452b81dbd1ef79372b75
https://www.notion.so/workspace/Page-Title-b55c9c91384d452b81dbd1ef79372b75
https://www.notion.so/aabbccdd00112233aabbccdd00112233?p=11223344556677881122334455667788

​
Unique IDs

If your Notion database uses the unique ID property, cubic detects codes like TASK-123 in your PR title or branch name. It searches across all accessible databases in your workspace for a matching prefix and resolves the page automatically. Include the identifier in your branch name (feature/TASK-123-add-auth) or PR title ([TASK-123] Add authentication) for cubic to link the page. Once connected, you can also manually link Notion pages directly in the cubic PR interface.

​
Best practices

  • Write clear acceptance criteria in Notion pages for better AI feedback
  • Use Notion’s unique ID property in databases so cubic can detect task codes in branch names and PR titles
  • Format requirements as bullet points or numbered lists for automatic issue analysis
  • Link architecture and design documents to PRs that implement those designs
  • Create custom agents that reference Notion context for domain-specific checks