08-tooling

notion task board reference

2026-04-11·tooling-reference

Notion Task Board — Reference for Ray

Durable reference doc so future Claude sessions can interact with the task board quickly and reliably without re-deriving the schema each time. Update this doc when the schema changes.

Locations

Schema

Property Type Options / Notes
Task title Required. The task title — keep it short, imperative, descriptive.
Status select Inbox, To Do, In Progress, Blocked, Done, Archived
Priority select Urgent (red), High (orange), Medium (yellow), Low (gray)
Owner select Ray (blue), Founder (purple), Both (green)
Project select Ops, Squarely, phData, Newsletter, Data Marketplace, Life, Mammoth Growth
Notes text Long-form description, context, acceptance criteria, progress updates.
Due Date date Optional. Use for time-bound work.
Created created_time Auto — do not set.

Status semantics

Owner semantics

Priority ordering (check-board sort)

Check-board skill sorts tasks by:

  1. Priority: Urgent → High → Medium → Low
  2. Owner = Ray or Both first (Founder is skipped)
  3. Status = To Do before Blocked

Pick top and work up to 3 per check cycle.

Task-creation conventions

Use these conventions so tasks are clearly autonomous-ready:

For a Ray-autonomous task:

For a decomposable multi-item job (like the newsletter backfill): Use the discovery → batch two-tier pattern (see ~/.claude/projects/-Users-ray/memory/feedback_queue_work_to_the_board.md):

  1. Create ONE discovery task per source that scans, counts, and creates N batch tasks on the board.
  2. Each batch task is independent and fits in one session's context budget.
  3. Batch tasks reference their source and range explicitly in the title (e.g. "Backfill Stratechery [1-20]").

Creating tasks programmatically (Notion MCP)

Use mcp__claude_ai_Notion__notion-create-pages with:

Example:

{
  "parent": {"type": "data_source_id", "data_source_id": "ae46c40f-421d-4c94-924b-0a2b13de0756"},
  "pages": [{
    "properties": {
      "Task": "Discover backfill: email@stratechery.com",
      "Status": "To Do",
      "Priority": "High",
      "Owner": "Ray",
      "Project": "Newsletter"
    },
    "content": "## What\nQuery Gmail for `from:email@stratechery.com`, determine total message count, and create batch tasks on the board of ~20 articles each (oldest first).\n\n## Acceptance\n- N batch tasks created, each titled `Backfill Stratechery [start-end]`\n- Discovery summary note filed at `06-reference/2026-04-11-backfill-discovery-stratechery.md`\n\n## Skill\nFollow discovery workflow in `~/.claude/skills/process-newsletter/SKILL.md`.\n\n## Context cost\nS (~5 minutes)"
  }]
}

Updating tasks

Use mcp__claude_ai_Notion__notion-update-page with the page ID returned from create-pages or from a fetch. Update Status before starting work, again on completion, and append to Notes with progress.

Search & query

Related