Notion-Based Rapid Prototyping

A multi-agent system that monitors Notion databases and automatically generates complete application prototypes. Describe your app idea in Notion, add a {{prototype: type}} tag, and agents build it in an isolated git worktree.

Prototype Types

Tag	Workflow	Output
{{prototype: uv_script}}	/plan_uv_script	Python CLI tool (UV inline deps)
{{prototype: vite_vue}}	/plan_vite_vue	Vue 3 + TypeScript + Vite web app
{{prototype: bun_scripts}}	/plan_bun_scripts	Bun TypeScript service/API
{{prototype: uv_mcp}}	/plan_uv_mcp	MCP server for AI tool integration

Notion Task Format

Title: Build a GitHub Issue Tracker CLI

Create a CLI tool to:
- List issues by repo
- Create issues with templates
- Export to CSV

{{prototype: uv_script}}
{{app: gh-tracker}}
{{model: opus}}

execute

The task becomes eligible when the last content block starts with execute or continue - <prompt>.

Environment Setup

# Required
export NOTION_AGENTIC_TASK_TABLE_ID=your-notion-db-id

Running the System

# Continuous monitoring (15s interval)
uv run adws/adw_triggers/adw_trigger_cron_notion_tasks.py

# Single pass — process all eligible tasks and exit
uv run adws/adw_triggers/adw_trigger_cron_notion_tasks.py --once

# Dry run — logs what would run without executing
uv run adws/adw_triggers/adw_trigger_cron_notion_tasks.py --dry-run

# Stop the monitor
./scripts/kill_notion_cron.sh

# Clean up old worktrees
./scripts/prune_worktrees.sh

Workflow Scripts

• adw_build_update_notion_task.py — 2-phase: /build → /update_notion_task
• adw_plan_implement_update_notion_task.py — 3-phase: /plan_{prototype} → /implement → /update_notion_task. Accepts --prototype flag.
• adw_trigger_cron_notion_tasks.py — Polls Notion every 15s, claims tasks to In progress, spawns detached subprocesses.

Task Eligibility

A Notion task is eligible when:

1. Status is Not started or HIL Review
2. Last content block starts with execute or continue - <prompt>

Supported Tags

Tag	Effect
{{prototype: type}}	Triggers specialized plan command
{{model: opus/sonnet}}	Claude model override
{{workflow: plan}}	Force 3-phase workflow (even without prototype)
{{worktree: name}}	Pre-specify worktree name
{{app: name}}	Target app directory name

Slash Commands

Command	Purpose
/get_notion_tasks	Query Notion DB for eligible tasks, returns JSON array
/update_notion_task	Update Notion page status with callout blocks
/update_notion_task_with_file	Post agent output files to Notion as formatted blocks
/make_worktree_name	Generate descriptive worktree name from task description
/plan_uv_script	Plan UV single-file Python script MVP
/plan_vite_vue	Plan Vite + Vue 3 web application MVP
/plan_bun_scripts	Plan Bun TypeScript application MVP
/plan_uv_mcp	Plan MCP server for AI tool integration