The Problem

This repo is a curated resource collection for the book AI Engineering (Chip Huyen, 2025), not a software project with runnable application code. Engineers seeking testable entry points, CI-guarded workflows, or runtime dependencies will find none. The repository has no license, no test suite, and no automation gate, making it unclear how materials can be redistributed or built upon without legal ambiguity. It functions as reference documentation, not a codebase to execute.

What This Does

The repo organizes end-of-chapter study notes, table-of-contents, prompt examples, case studies, misalignment analyses, and multilingual translations (17 languages tracked in translations.md). The only runnable artifact is scripts/ai-heatmap.ipynb, a Jupyter notebook that generates conversation heatmaps from ChatGPT/Claude exports. Supporting assets (assets/, 30 files) cover book artwork, architecture diagrams, and edition-specific covers. case-studies.md and prompt-examples.md provide real-world patterns and reusable prompt structures. All other files are static markdown, PDFs, or images with no code execution path.

How It Is Wired

The wiring has not been mapped for this repository yet. There are no functions, entry points, or module graphs that touch databases, networks, or the filesystem during execution. The sole script, scripts/ai-heatmap.ipynb, accepts conversation export data as input and outputs a visualized heatmap; its internal data flow lives within the notebook’s cells and is not exposed as a callable API or module. No other file in the repo initiates network I/O, file writes beyond asset hosting, or state persistence. Any "execution" is confined to opening the notebook in Jupyter and running its cells manually.

How To Use It

  • Setup: No installation command is required for the resource files. To run the heatmap notebook, open scripts/ai-heatmap.ipynb in Jupyter (jupyter notebook scripts/ai-heatmap.ipynb) and execute its cells. The notebook does not declare pinned dependencies in the repo; install jupyter, matplotlib, and pandas locally if needed.
  • Configuration: No environment variables, API keys, or config files are required for the static materials. The notebook may require a conversation export (JSON/CSV format) as input—consult the notebook’s markdown cells for the expected schema.
  • Running it: Browse ToC.md for chapter navigation, chapter-summaries.md for section overviews, or study-notes.md for condensed takeaways. Use prompt-examples.md for reusable prompt templates. All are plain-text markdown, readable without a runtime.

Real-World Use

An AI engineering team conducting a comparative study of LLM conversation patterns can use the heatmap notebook to upload ChatGPT and Claude export files, generating side-by-side visualizations of turn-taking and response-length distributions. The resulting images can be referenced alongside case-studies.md to ground observations in documented industry patterns, or prompt-examples.md to validate whether observed prompts align with the book’s recommended patterns. The multilingual translation index (translations.md) also offers a quick check for regional content availability when tailoring case studies for global teams.

Code Health & Issues

  • [Medium/SDLC] No test files detected – untested code paths – repository-wide (0 test files found across 46 files)
  • [Medium/SDLC] No CI/CD pipeline detected – no automated build/test gate – .github/ or CI config absent from root
  • [Medium/SDLC] No LICENSE file – unclear usage/redistribution rights – root directory

Beyond these measured findings, the repo’s structure confirms it contains no application code, so traditional code health metrics (complexity, coverage, dependency scans) do not apply. The three items above are the only SDLC gaps evidenced by the file layout.

The Bottom Line

This is a high-quality reference repository for the AI Engineering book: well-organized study notes, prompt libraries, case studies, and a multilingual translation index make it useful for learning, evaluation framing, and prompt engineering inspiration. The ai-heatmap.ipynb notebook provides a functional, low-friction tool for conversation visualization. However, there is no production code, no tests, no CI/CD, and no license—treating it as a software project would require adding governance from scratch. Consultants should use it for ideation and framework reference, not as a starting point for shipped systems without layering their own testing, licensing, and automation.

Clone: https://github.com/moses-y/aie-book