Notion Admin Skill

Procedural guidance for Notion administration in AskElephant's Product teamspace (V2 structure).

When to Use

• Running /notion-admin [mode]
• Running /full-sync when Notion write operations are required
• Auditing Notion project hygiene or launch readiness data

Notion V2 Architecture

The Product teamspace follows a 4-layer system. Full DB IDs and structure: pm-workspace-docs/runbooks/notion-v2-implementation-guide.md

Sidebar Structure

• Product Home (dashboard with linked views)
• Teams Roster [DB, L1] → WHO is building?
• Strategy & Context (Company Context, Competitor Research)
• Roadmap [DB] → Initiatives [DB] → Projects [DB, L2] → Milestones → Tasks [L3]
• Weekly Updates [DB, L4] → What to PAY ATTENTION to?
• Documentation (PRDs, Design Specs, Tech Specs, Research, Videos)
• Feedback (Companies, Contacts, Triage, Feature Requests)
• Meetings (Recurring, One-Off, Notes, Decision Log)
• Product Usage & Metrics (PostHog, Insights, Events, Experiments)
• Process & Templates (Process, Release Gates, Org Chart, Retros)
• External Tool Links (Linear, Slack, PostHog, GitHub)

MCP Server

• composio-config (Notion toolkit via Composio)

Core Operations

• audit: orphaned rows, stale projects, missing relations
• projects: normalize project metadata in Projects DB
• roadmap: maintain Roadmap → Initiatives → Projects hierarchy
• weekly-update: create Weekly Updates entries (Layer 4)
• feedback: triage feedback pipeline (Companies → Contacts → Triage → Feature Requests)
• decisions: maintain Decision Log from meeting notes
• launches: track milestones and launch readiness
• prd [name]: create or update PRD-linked records in Documentation section
• eow [date]: create weekly sync artifacts

Safety Rules

1. Never hard-delete. Archive or mark inactive instead.
2. Confirm before any bulk write pattern.
3. Fetch schema before mutating unknown properties.
4. Log every operation to a dated status file.

Output and Logging

• Audit and operation logs: pm-workspace-docs/status/notion/admin/
• EOW artifacts: pm-workspace-docs/status/eow-*.md
• Notable changes as signals: pm-workspace-docs/signals/notion/