| name | build-notebook |
| description | Build or improve Jupyter notebooks iteratively with quality scoring. Arguments: <new|improve|fix> <path> [--topic] [--domain] [--level] [--quality] [--max-iter] |
Build Notebook
Create, improve, or fix Jupyter notebooks iteratively.
Action: $ARGUMENTS
Actions
new - Create from scratch
Requires: --topic, --domain (ML, Probas, GenAI, GameTheory, SymbolicAI, Sudoku, Search), --level (intro, intermediate, advanced)
improve - Enhance existing notebook
Requires: notebook path, optional --quality (0-100, default 90), --focus (execution, pedagogy, content, structure)
fix - Correct execution errors
Requires: notebook path, optional --max-iter (default 5)
Iterative Workflow
while iteration < max_iterations and score < quality_target:
1. Execute notebook (notebook-executor agent)
2. Validate all aspects (notebook-validator agent)
3. Plan corrective actions (prioritized by severity)
4. Apply via appropriate sub-agent (enricher, cell-iterator, cleaner)
5. Re-validate and measure improvement
Quality Scoring
| Category | Weight | Criteria |
|---|
| Structure | 15% | Valid JSON, metadata, cells |
| Syntax | 15% | Valid code, markdown, LaTeX |
| Execution | 30% | No errors, no timeouts |
| Pedagogy | 25% | Progression, code/markdown ratio, explanations |
| Content | 15% | Visualizations, formulas, conclusion |
Sub-Agents Used
| Agent | Role | Model |
|---|
| notebook-designer | Create initial structure | inherit |
| notebook-executor | Run the notebook | sonnet |
| notebook-validator | Evaluate quality | sonnet |
| notebook-enricher | Add pedagogical content | sonnet |
| notebook-cell-iterator | Fix specific cells | sonnet |
| notebook-cleaner | Clean structure | sonnet |
Model Selection Strategy
- Use
haiku for quick validation checks
- Use
sonnet for enrichment and standard fixes
- Use
inherit (or opus if available) for complex design and orchestration
