Stunspot’s Guide to AI Systems — The AI Engineering Systems Canon. A comprehensive field manual for practical AI systems design.

Stunspot’s Guide to AI Systems

The AI Engineering Systems Canon
A comprehensive field manual for practical AI systems design.

Status Reports Volumes License: CC BY 4.0 DOI

Stunspot’s Guide to AI Systems is a Markdown-native knowledge repository built primarily to support AI-assisted design, engineering, analysis, evaluation, and decision-making across modern AI systems.

Its main audience is the model.

When loaded into an AI workspace, RAG pipeline, long-context session, agent memory layer, project knowledge base, or retrieval corpus, the Guide functions as a dense architectural substrate: it gives the assisting model structured doctrine, field vocabulary, decision frameworks, failure maps, design patterns, evaluation logic, and operational heuristics for reasoning about AI systems with far greater precision.

Human readers can use it as a field manual, but its deeper purpose is practical augmentation: to make AI systems better at helping engineers, builders, prompt designers, product leads, and technical decision-makers reason through the design and operation of AI systems.

The canon organizes AI engineering as a layered discipline spanning model steering, context architecture, corpus engineering, retrieval, model lifecycle, runtime mechanics, agents, tools, multimodal interfaces, security, resilience, evals, telemetry, governance, product architecture, and system doctrine.

AI systems are probabilistic cognitive engines operating inside deterministic operational environments. Good AI engineering means designing the interfaces, constraints, context, tools, feedback loops, and human controls that let that probabilistic core behave usefully, safely, and economically under real conditions.

Use it as reference material.
Use it as RAG substrate.
Use it as project knowledge.
Use it as doctrine for AI agents tasked with designing, critiquing, or improving AI systems.

Part of the Stunspot’s Guide to… Advanced Knowledge Base Library.
Browse the full library: Gateway Repo · stunspot.com


Start Here

Knowledge Packs

For AI Projects, RAG systems, NotebookLM-style tools, and long-context workspaces, start with the bundled knowledge packs.

Pack Files Best Use Link
By Part 5 Recommended default. Broad coverage with low file count. Open By Part pack
By Volume 12 Smaller files and cleaner retrieval boundaries. Open By Volume pack
Omnibus 1 Full canon in one file for archival, local search, or systems that handle large single-file sources well. Open Omnibus
Source Reports 37 Best for cloning, precise indexing, citation, editing, and source navigation. Open Canon Map

Most users should start with the By Part pack. It preserves the canon’s structure while avoiding both extremes: one giant file or 37 separate reports.


Full Canon

Part I — Foundations of AI Systems

Part II — Agentic and Multimodal Systems

Part III — Failure, Security, and Resilience

Part IV — Evaluation, Operations, and Governance

Part V — Product Doctrine and Engineering Method


What This Canon Covers

The canon is organized across 12 volumes and 37 reports, from AI-ENG-A through AI-ENG-AK.

It covers:


Suggested Reading Paths

For RAG and Knowledge Systems

  1. AI-ENG-A — Model Steering
  2. AI-ENG-B — Context Architecture
  3. AI-ENG-D — Corpus Engineering
  4. AI-ENG-E — The Retrieval Pipeline
  5. AI-ENG-F — Knowledge Freshness, Conflict Detection & Context Rot Prevention

For Agentic Systems

  1. AI-ENG-A — Model Steering
  2. AI-ENG-M — Agentic Orchestration
  3. AI-ENG-N — Tool Contracts
  4. AI-ENG-O — Action Verification
  5. AI-ENG-S — Production Pathologies

For Model Selection, Adaptation, and Serving

  1. AI-ENG-C — The Economic Physics of Inference
  2. AI-ENG-G — Model Selection
  3. AI-ENG-H — Model Adaptation
  4. AI-ENG-J — Throughput Mechanics
  5. AI-ENG-K — Weight Dynamics
  6. AI-ENG-L — Model Serving Architecture

For Security, Reliability, and Governance

  1. AI-ENG-S — Production Pathologies
  2. AI-ENG-T — Boundary Defense
  3. AI-ENG-U — AI Supply Chain Security
  4. AI-ENG-Z — Strategic Telemetry
  5. AI-ENG-AA — Evals Architecture
  6. AI-ENG-AC — AI Operations
  7. AI-ENG-AD — Governance Architecture

For Product, Adoption, and Organizational Design

  1. AI-ENG-X — Human-System Interface
  2. AI-ENG-Y — High-Impact Workflow Design
  3. AI-ENG-AF — AI Product Architecture
  4. AI-ENG-AG — Adoption Systems
  5. AI-ENG-AH — Build, Buy, Open Source & Vendor Strategy

For the Doctrinal Spine

  1. AI-ENG-AI — Contract Thinking
  2. AI-ENG-AJ — AI System Design Patterns
  3. AI-ENG-AK — The AI Engineering Mindset

Use as AI Knowledge Substrate

The Canon is designed to be useful when placed inside AI systems as structured knowledge.

Possible uses include:

For best results, load only the portions relevant to the current task, then instruct the model to treat the Canon as governing reference material for analysis and design.

Example instruction:

Analyze, design, critique, or improve the requested AI system using Stunspot’s Guide to AI Systems as governing reference material, not decorative background reading. Begin by retrieving and applying the Guide’s vocabulary, doctrine, design patterns, failure modes, interface logic, evaluation standards, and operational assumptions as the frame through which the system is understood. Treat the Canon as a working engineering discipline: use it to sharpen definitions, expose hidden constraints, identify brittle abstractions, detect hallucination-prone or evaluation-weak components, and convert vague AI ambition into deployable system logic.


Attribution and Citation

Created by Sam “stunspot” Walker / Collaborative Dynamics.

Suggested plain-text citation:

Walker, Sam “stunspot.” The AI Engineering Systems Canon: A Doctrinal Knowledge Base for High-Dimensional AI System Architecture. Collaborative Dynamics.


Repository Structure

.
├── README.md
├── LICENSE.md
├── CITATION.cff
├── knowledge-packs/
│   ├── by-volume/
│   ├── by-part/
│   └── omnibus/
└── docs/
    ├── index.md
    ├── canon-map.md
    ├── knowledge-packs.md
    ├── how-to-use-this-canon.md
    ├── _config.yml
    ├── _layouts/
    │   └── default.html
    ├── assets/
    │   ├── brand/
    │   └── css/
    │       └── style.css
    ├── volume-01/
    ├── volume-02/
    ├── volume-03/
    ├── volume-04/
    ├── volume-05/
    ├── volume-06/
    ├── volume-07/
    ├── volume-08/
    ├── volume-09/
    ├── volume-10/
    ├── volume-11/
    └── volume-12/

Disclaimer

This corpus was constructed with a mix of GPT and Gemini Deep Research. Its specific nature severely mitigates against Deep Research’s rare hallucination, and I have seen maybe 5 instances of such across dozens of similar knowledge bases, but errors ARE possible with AI. It is at least as reliable as a comparable 1600 page textbook written by humans and so far seems substantially more so.

That said, I am not a software engineer or coder of any kind. I am a prompt engineer and AI operations expert. My skills are not in programming or KV cache optimization; they lie in knowing how to elicit superb results from the model and how to recognize and correct it when it has an error of operation. I cannot create a new architecture on my own. I can teach the model how to do it for me.

And now it can do so for you, as well.

–stunspot ⟨🤩⨯📍⟩ and 💠‍🌐Nova