Release Notebook

Creates a dedicated NotebookLM notebook for the current OrchestKit release, preserving changelog details, project instructions, and the plugin manifest as a queryable knowledge base.

See rules/workflow-versioned-notebooks.md in the notebooklm skill for the canonical versioned-notebook pattern this skill implements.

Preconditions

Before running:

nlm login --check — confirm an active session (~20 min TTL)
If session expired: nlm login (re-authenticates via browser)
If notebooklm-mcp-cli is not installed: uv tool install notebooklm-mcp-cli

Workflow

Execute all steps in order. Stop and report if any MCP call fails.

Step 1 — Read Release Metadata

# Read version (e.g. "7.0.1")
Read: package.json  →  extract .version

Derive notebook title and major.minor label:

FULL_VERSION  = package.json .version          # e.g. "7.0.1"
MINOR_LABEL   = MAJOR.MINOR of FULL_VERSION    # e.g. "7.0"
NOTEBOOK_TITLE = "OrchestKit v{MINOR_LABEL} — Release KB"

Patch releases (x.y.Z where Z > 0) append to the existing minor notebook when it already exists. If this is the first patch of a minor series, create a new notebook.

Step 2 — Extract CHANGELOG Section

Read: CHANGELOG.md

Extract the section that starts with ## [7.0.1] (or whichever FULL_VERSION is current) up to — but not including — the next ## [ heading. Store as CHANGELOG_SECTION.

If the version section is not found, halt and report: "CHANGELOG.md has no entry for v{FULL_VERSION}. Add one before creating the Release KB."

Step 3 — Read Project Sources

Read: CLAUDE.md          →  CLAUDE_CONTENT
Read: manifests/ork.json →  MANIFEST_CONTENT

Step 4 — Create Notebook

notebook = mcp__notebooklm-mcp__notebook_create(
    title="OrchestKit v{MINOR_LABEL} — Release KB"
)
# Save: notebook_id = notebook.id

Step 5 — Add Sources

Add each source separately for better retrieval chunking:

# Source 1: changelog section
mcp__notebooklm-mcp__source_add(
    notebook_id=notebook_id,
    type="text",
    title="CHANGELOG v{FULL_VERSION}",
    content=CHANGELOG_SECTION
)

# Source 2: project instructions
mcp__notebooklm-mcp__source_add(
    notebook_id=notebook_id,
    type="text",
    title="CLAUDE.md — Project Instructions",
    content=CLAUDE_CONTENT
)

# Source 3: plugin manifest
mcp__notebooklm-mcp__source_add(
    notebook_id=notebook_id,
    type="text",
    title="manifests/ork.json — Plugin Manifest",
    content=MANIFEST_CONTENT
)

Step 6 — Add Release Summary Note

mcp__notebooklm-mcp__note(
    notebook_id=notebook_id,
    action="create",
    content="Release KB for OrchestKit v{FULL_VERSION}. Sources: CHANGELOG section, CLAUDE.md, manifests/ork.json."
)

Step 7 — Generate Audio Overview

Audio generation is async. Create, then poll until complete or failed.

# Trigger generation
artifact = mcp__notebooklm-mcp__studio_create(
    notebook_id=notebook_id,
    type="audio_overview"
)

# Poll (check every ~30s; generation takes 2-5 min)
status = mcp__notebooklm-mcp__studio_status(artifact_id=artifact.id)
# Repeat until status in ("completed", "failed")
# Inform user: "Generating audio overview... (status: {status})"

If generation fails, log the failure but do not halt — the notebook is still useful without audio.

Step 8 — Share Notebook

# Check current sharing status first
share_status = mcp__notebooklm-mcp__notebook_share_status(notebook_id=notebook_id)

# Invite project owner as writer
mcp__notebooklm-mcp__notebook_share_invite(
    notebook_id=notebook_id,
    email="yonatan2gross@gmail.com",
    role="writer"
)

Do not enable public link unless the user explicitly requests it — release notebooks may contain pre-release details.

Step 9 — Output Summary

Print a structured summary:

Release KB created for OrchestKit v{FULL_VERSION}

  Notebook : OrchestKit v{MINOR_LABEL} — Release KB
  ID       : {notebook_id}
  Sources  : CHANGELOG v{FULL_VERSION} | CLAUDE.md | manifests/ork.json
  Audio    : {completed | failed | pending}
  Shared   : yonatan2gross@gmail.com (writer)

Query this notebook with:
  notebook_query(notebook_id="{notebook_id}", query="What changed in v{FULL_VERSION}?")

Error Handling

Error	Action
`nlm login` session expired	Halt. Print: "Run `nlm login` to re-authenticate, then retry."
notebook_create fails	Halt. Print MCP error. Check `nlm login --check`.
source_add fails on one source	Log warning, continue with remaining sources.
CHANGELOG section missing	Halt before notebook_create. Report missing entry.
studio_create fails	Log warning, continue — notebook is still valid.
studio_status = "failed"	Log warning with artifact ID, continue.

Related Skills

ork:notebooklm — Full NotebookLM MCP tool reference and workflow patterns
ork:release-checklist — Pre-release gates (run before this skill)
ork:release-management — GitHub release creation with gh CLI

release-notebook