Notion Board

Use this skill to make Notion the working surface for a repository while keeping technical facts sourced from the repo.

Operating model

• Treat Notion interaction as backend-agnostic. Use whatever Notion capability already exists in the current session.
• Do not add backend-specific workflow to this skill.
• Keep the Notion data model fixed regardless of the backend. Read references/board-schema.md before creating or repairing the board.
• Use scripts/notion_board.py only for local state management after the Notion work is done.

Create or bind a board

1. Resolve the repo root. Prefer git rev-parse --show-toplevel; if it fails, use the current directory and call out the downgrade.
2. Check .agents/notion-board/state.json for an existing local binding.
3. If the board already exists, inspect it and confirm whether it already matches the schema in references/board-schema.md.
4. If the board does not exist, create the root page, Project Guide, and the required databases.
5. After the board exists, write the local binding with: