new-notebook

name	new-notebook
description	Creates a Quarto notebook (.qmd) and registers it in _quarto.yml. Use when adding a new notebook.
argument-hint	<name> <title>
allowed-tools	Bash, Read, Write, Edit, Glob, Grep
version	1.0.0
workflow_stage	analysis
tags	["notebook","Quarto","scaffold"]

Create New Notebook

Create a new Quarto notebook (.qmd) and register it in the manuscript.

Arguments

• $ARGUMENTS — the notebook name and title (e.g., "notebook-04 Spatial Analysis")

Steps

1. Parse the name and title from the arguments. Follow the naming convention: notebook-NN.qmd (sequential numbering)
2. Check notebooks/ for existing notebooks to determine the next number
3. Create the .qmd file in notebooks/ with:
   • YAML frontmatter specifying title and jupyter kernel (ask user: Python → python3, R → ir, Stata → nbstata)
   • A first code cell that sets the random seed for reproducibility:
     • Python: import random; import numpy as np; random.seed(42); np.random.seed(42)
     • R: set.seed(42)
     • Stata: clear all followed by set seed 42
   • A markdown section with the notebook title and overview
   • Content structure: Import → EDA → Analysis (see existing notebooks for reference)
   • Pedagogical comments: Add markdown narrative between code blocks explaining what the code does, why it matters, and how to interpret the output
   • Figures: 6×4 inches, 300 DPI, exported to ../images/<label>.png
   • Tables: Export to ../tables/<label>.csv, ../tables/<label>.md, and ../tables/<label>.tex
   • See CLAUDE.md § Notebook Conventions for language-specific export patterns
4. Register the notebook in _quarto.yml under manuscript.notebooks:

   - notebook: notebooks/<name>.qmd
     title: "<title>"
   

5. To embed outputs in index.qmd:
   • Figures: {{< embed notebooks/<name>.qmd#fig-label >}}
   • Tables: {{< include tables/<label>.md >}} (with a bold caption and .table-notes div)
6. Confirm the notebook renders: quarto render notebooks/<name>.qmd