borghei/Claude-Skills / project-management/notion-pm
notion-pm
VerifiedDesigns Notion databases, views and page structure for PRDs, OKRs, roadmaps and decisions, and writes REST API calls. Use when asked to "design a PRD database", sync Notion with Jira or Linear, or script the Notion API.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 10.2 KB |
| assets/notion-okr-template.md | markdown | 6.9 KB |
| assets/notion-prd-template.md | markdown | 4.5 KB |
| assets/notion-roadmap-template.md | markdown | 5.1 KB |
| examples/product-team-workspace-buildout.md | markdown | 10.5 KB |
| references/notion-api-patterns.md | markdown | 13.8 KB |
| references/notion-database-design-for-pm.md | markdown | 9.8 KB |
| references/notion-pm-playbook.md | markdown | 16.9 KB |
| references/red-flags.md | markdown | 10.3 KB |
assets/notion-roadmap-template.md
View on GitHub# Notion Roadmap Template
Drop-in schema and view definitions for the Roadmap database. Copy the property list into a new Notion database, then create the views described below.
---
## Database properties
| Property | Type | Configuration |
|---|---|---|
| Title | title | (required) |
| ID | unique_id | Prefix: `ROAD` |
| Horizon | select | Options: `Now`, `Next`, `Later` (or `Q1 2026`, `Q2 2026`, ...) |
| Status | status | To-do: `Discovery` · In progress: `Defining`, `Building` · Complete: `Shipped`, `Killed` |
| Owner | people | One PM |
| Customer Outcome | rich_text | One sentence outcome |
| OKR | relation | → OKRs database |
| PRDs | relation | → PRDs database |
| Start | date | Range start |
| End | date | Range end |
| Confidence | select | `High` (green) / `Medium` (yellow) / `Low` (red) |
| Audience | multi_select | `Internal`, `Customer`, `Exec`, `Board` |
| Teams Involved | multi_select | `Eng`, `Design`, `Data`, `Marketing`, `Sales`, `Support` |
| Dependencies | relation (self) | Cross-row dependencies |
| Last Updated | date | Auto-set on status change (manual or automation) |
| Latest Update | rich_text | One-paragraph update |
| Risk Level | select | `Low` / `Medium` / `High` |
| Customer Quotes | rich_text | Pull quotes for exec views |
| PRD Count | rollup | Source: PRDs, property: Title, calc: Count |
| PRDs Shipped | rollup | Source: PRDs, property: Status, calc: Count where = Shipped |
---
## Recommended views
### View 1: Timeline (Default)
- **Type:** Timeline
- **Date source:** Start / End
- **Group by:** Horizon
- **Filter:** Status not in (Killed)
- **Sort:** Start ascending
- **Visible properties:** Title, Owner, Status, Confidence, OKR, PRD Count
- **Use:** Quarterly planning, sequencing, dependency conflicts
### View 2: Now / Next / Later Board
- **Type:** Board
- **Group by:** Horizon
- **Filter:** Status not in (Killed, Shipped)
- **Sort:** Confidence descending, then Start ascending
- **Visible properties:** Owner, Customer Outcome, OKR, Confidence, Risk Level
- **Use:** Strategic conversations, team standups
### View 3: Exec Read-Out
- **Type:** Table
- **Filter:** Audience contains Exec; Status not in (Killed)
- **Sort:** Horizon ascending, then Start ascending
- **Visible properties (in order):** Title, Customer Outcome, Owner, Status, Confidence, End, Latest Update, Risk Level
- **Hidden:** PRDs, Dependencies, Teams Involved
- **Use:** Monthly exec roadmap review; export as PDF
### View 4: Customer-Facing
- **Type:** Gallery
- **Filter:** Audience contains Customer; Status not in (Killed)
- **Card preview:** page content or cover image
- **Visible properties:** Customer Outcome, Horizon, End, Confidence
- **Use:** Source for customer-facing roadmap pages, sales decks
### View 5: At Risk
- **Type:** Table
- **Filter:** (Risk Level = High) OR (Confidence = Low) OR (Status = Defining AND End < today + 30d)
- **Sort:** End ascending
- **Visible properties:** Title, Owner, Status, Risk Level, Confidence, End, Latest Update
- **Use:** Weekly portfolio risk review
### View 6: Dependencies Graph
- **Type:** Table grouped by Owner
- **Filter:** Dependencies is not empty
- **Sort:** Start ascending
- **Visible properties:** Title, Dependencies, Owner, End
- **Use:** Identify critical-path coordination needs (also see `execution/dependency-map/`)
### View 7: Shipped (Archive)
- **Type:** Table
- **Filter:** Status = Shipped
- **Sort:** End descending
- **Visible properties:** Title, Owner, Customer Outcome, OKR, End, PRD Count
- **Use:** Retrospective, "what shipped this quarter" updates
---
## Page body template (for each roadmap row)
```
# <Initiative Name>
> [!NOTE]
> **Customer outcome:** <one sentence>
> **OKR:** @OKR-014 (Increase activation to 45%)
> **Horizon:** Now · **Confidence:** Medium · **Owner:** @PM
## Problem
What customer/business problem this initiative solves.
## Strategy
The approach and why it is the right one now.
## Phases / Milestones
| Phase | Description | Target |
|---|---|---|
| Discovery | Customer interviews + prototype | YYYY-MM-DD |
| Build MVP | Core flow shipped to alpha | YYYY-MM-DD |
| Iterate | Validate metrics, expand scope | YYYY-MM-DD |
| GA | General availability | YYYY-MM-DD |
## Underlying PRDs
- @PRD-018: <PRD title>
- @PRD-024: <PRD title>
## Dependencies
- @ROAD-005 (depends on auth-svc rewrite)
## Risks
- <Risk 1>: mitigation
- <Risk 2>: mitigation
## Latest update (YYYY-MM-DD)
- <bullet>
- <bullet>
## Customer voice
> "<quote>" — @Customer Research entry
```
---
## Automation suggestions
- **On Status → Shipped:** auto-set `End` to today.
- **On Status change:** prompt Owner to update `Latest Update` (Slack reminder).
- **Weekly Friday:** post a summary of At Risk view items to `#leadership-roadmap`.
- **On PRD Status → Shipped:** rollup `PRDs Shipped` increments; auto-recompute progress.
---
## Audit cadence
- **Weekly:** Owner reviews their rows; updates `Latest Update` and `Risk Level`.
- **Monthly:** Head of Product reviews At Risk view; rebalances confidence.
- **Quarterly:** Full roadmap review; merge/split rows; promote `Next` → `Now`.
- **Annually:** Archive Shipped rows older than 18 months to a "Roadmap Archive" database.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |