cookbook-audit

Audit a Cookbook notebook using a rubric and style guide to score quality and provide actionable improvements.

• Evaluate notebook against style guide and rubric
• Score narrative, code, technical accuracy, and actionability
• Provide specific, line-referenced improvement suggestions
• Ensure no hardcoded API keys or technical debt

• Must read style_guide.md first
• Use detect-secrets to find hardcoded API keys
• Score each dimension (1-5) with justification
• Generate structured audit report with strengths and issues
• Prioritize actionable, line-referenced recommendations
• Must map conclusions back to learning objectives
• Must suppress pip install logs with %%capture
• Must use dotenv.load_dotenv() not os.environ

1. 1.Read style_guide.md to understand best practices
2. 2.Ask for notebook path if not provided
3. 3.Run validate_notebook.py to detect technical issues
4. 4.Review generated markdown in tmp/ folder
5. 5.Manually assess against rubric and scoring guidelines
6. 6.Score each dimension and provide specific examples
7. 7.Follow audit report format with executive summary and recommendations