Skip to content

isatimur/ai-engineering-book-lab

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

398 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

From Copilot to Colleague

A public experiment: can autonomous research loops produce a real, source-anchored book on AI engineering?

Read it online   GitHub stars   License: MIT   Built with autoresearch   Claims verified   claims-ledger

A book on AI engineering where every claim links to the exact second of the talk it came from — distilled from 794 practitioner talks, and graded by a panel of three rival AI models so no single model gets to flatter the prose.


The Autoresearch Knowledge Machine


Models create possibility. Scaffolding creates trust. Organizations decide whether that trust compounds.

The thesis of the manuscript, in one line. The repo is the system that produced it.


Why this exists

Most "AI-written" books produce slop because they have no source of truth — the model just remixes what it was trained on. The Lab is a different bet: a corpus of practitioner talks (the AI Engineer YouTube channel, 794 videos), a bounded autonomous research loop, and a discipline that no claim ships without a source anchor — a precise pointer to the moment in a video where it came from.

The visible output is From Copilot to Colleague: How AI Engineering Turns Models into Dependable Systems — a ten-chapter manuscript at fromcopilottocolleague.com.

The actual deliverable is The Method — the reproducible research-and-writing machine you can read in programs/ and watch run in research_passes/. The manuscript is proof that the method works.


The Manuscript — read it now

From Copilot to Colleague

Ten chapters in a four-act arc — Problem (1–2), Scaffolding Stack (3–7), Stress Test (8), Widening (9–10). Each chapter:

  • opens with an Evidence of Source exhibit (the before-vs-after diagram, click to enlarge)
  • has three inline figures at section breaks
  • ends with an Evidence Rail — every claim links back to the exact YouTube moment it came from
  • shares a glossary system: dotted-underlined terms in the prose open a side drawer with the definition plus the concept diagram

→ Open the book  ·  → Browse the Visual Guide (73 diagrams)


The Method — how the book is built

The five-layer pipeline

A five-layer pipeline governed by a small Research-Org control plane:

Layer What lives there Repo dir
Source Practitioner videos as the corpus of record 01_Videos/ (notes) · channel metadata in 99_Meta/
Synthesis Themes, people, concepts derived from the corpus 02_Themes/ · 03_People/ · 04_Concepts/ · public versions in public/
Evidence Verified claims with anchored video timestamps claims/Claims Ledger.md · evidence/ · per-anchor JSON in claims/anchors/ · event ledgers · claims-ledger CI
Manuscript Chapter drafts that draw on evidence, never inventing public/drafting/ · rendered in website/src/content/chapter-*.md
Control plane The agent instructions, research passes, autoresearch loop programs/ · tasks/ · research_passes/

The agent loop is bounded: each pass takes a specific mission ("anchor claims 16–19", "rework summaries for videos 680–687"), runs to completion, commits its result, logs the pass. Every operation is reversible and auditable in git.

Read the loop's instructions: programs/book_autoresearch.md and programs/source_anchoring_pass.md.


What's genuinely novel here

  1. Source Anchors as a discipline. Every claim in the manuscript carries a video_id + start/end timestamp + verbatim quote. The website's Evidence Rail surfaces them under each chapter as clickable YouTube embeds. No anchor, no claim. The same grammar now ships as open-source CI: claims-ledger · browse event ledgers.
  2. Quality is measured, not vibed — by a panel of rival models. Every chapter is scored on six dimensions (humanness, voice, usefulness, evidence density, claim defensibility, redundancy) by a cross-family LLM judge panel — Meta Llama-3.3, Alibaba Qwen-2.5, and DeepSeek — and the median is the verdict. One model can't flatter prose shaped like its own output, and where the three disagree by more than 20 points, that cell is flagged as where to look. The live scorecard is at /quality; the rationale is in docs/judge-panel-decision.md.
  3. The book is the proof, not the product. The Method (the reproducible machine) is the actual artefact. The manuscript shows it works.
  4. Method ships with the artefact. Every agent instruction, every research pass log, every quality judge is in this repo — readable, criticisable, reproducible.
  5. 73 hand-built diagrams that argue visually instead of decorate. See diagrams/README.md for the full visual guide.

Quick tour of the repo

ai-engineering-book-lab/
├── .agents/skills/     # invokable agent Skills (SKILL.md + agents/openai.yaml per skill)
├── 01_Videos/          # source corpus (notes per video, 794+ entries)
├── 02_Themes/          # cross-corpus theme syntheses
├── 03_People/          # speaker profiles
├── 04_Concepts/        # concept pages (Harness, Eval, Context, etc.)
├── 99_Meta/            # corpus stats, ingest scripts, anchor builders
├── claims/             # canonical Claims Ledger + per-anchor JSON
│   ├── Claims Ledger.md
│   └── anchors/
├── diagrams/           # 73 hand-built diagrams (Excalidraw source + PNG)
│   ├── 01–14*.png      # 4 overview + 10 chapter openers
│   ├── concepts/       # 18 concept diagrams
│   ├── inline/         # 38 inline chapter figures
│   └── maps/           # 3 reader's path + methodology maps
├── docs/               # superpowers/specs and plans
├── evidence/           # evidence packs between notes and prose
├── programs/           # agent program instructions (autoresearch, anchoring)
├── public/             # public-safe curated mirror
│   ├── concepts/       # promoted concept pages
│   ├── drafting/       # chapter drafts
│   └── themes/         # promoted themes
├── remotion/           # explainer-video + OG-card renderer (React → video)
├── research_passes/    # cumulative logs of each autonomous pass
├── tasks/              # bounded agent missions
└── website/            # the Reader (React + Vite, deployed to Vercel)
    ├── src/            # catalogue, visual guide, reader pages + EvidenceRail
    ├── scripts/        # diagram sync + sitemap generators
    └── public/         # synced PNGs + manifest.json

A full description of public vs internal layers lives in PUBLIC_REPO_PLAN.md. The vocabulary the experiment uses is locked in CONTEXT.md (The Lab · The Method · The Manuscript · Claim · Source Anchor · Support level).


Infrastructure — claims-ledger

The book's Source Anchors discipline ships as open-source CI tooling:

Tool What it does Link
claims-ledger CLI + GitHub Action — every strong claim carries a verbatim quote anchor; CI exits 11 when stale github.com/isatimur/claims-ledger
Event ledgers Standalone talk ledgers with yt:// anchors (5 live samples) fromcopilottocolleague.com/ledgers
Sandbox Fork-and-run template — zero local install claims-ledger-sandbox
npx @claims-ledger/edt init   # after npm publish — see claims-ledger docs/NPM-PUBLISH.md

This repo gates its own claims via the same grammar — see .ledger/claims.md and the live badge above.


Status (2026-06)

Live counts are generated into STATS.md on every corpus change; the figures below are a snapshot.

  • 794 videos ingested from the AI Engineer channel
  • 54 claims anchored to video timestamps (44 strong, 10 moderate); 199 anchors, 198 high-confidence
  • 50 speaker profiles and 19 concept pages synthesized from the corpus
  • 10 chapters — all at Drafting depth — render live at fromcopilottocolleague.com/read
  • 73 hand-built diagrams (4 overview + 10 chapter openers + 18 concept + 38 inline + 3 maps)
  • Evidence Rail ships per chapter — every claim renders an embedded YouTube clip at its exact timestamp
  • Cross-family judge panel — every chapter scored on 6 dimensions by a median-of-three panel (Llama-3.3 · Qwen-2.5 · DeepSeek) so no single model grades its own style; live at fromcopilottocolleague.com/quality
  • Per-chapter SEO routes live (36 prerendered pages + sitemap + JSON-LD); machine-readable /llms.txt and full-text markdown for agents
  • CI/CD wired (build/test on PR, auto-deploy on push, evidence + stats regen on corpus/claims change) — see DEPLOY.md

How you can engage

This is a public experiment. A few entry points that are genuinely useful right now:

If you want to… Start here
Read the book fromcopilottocolleague.com — chapters render with their evidence rail
Push back on a claim Open an issue with the claim: prefix and quote the Claims Ledger entry
Add a source The corpus is the AI Engineer channel; for other sources, propose via an issue first — adding sources is a careful editorial call, not automatic
Improve a diagram All 73 are editable Excalidraw JSON; open diagrams/<name>.excalidraw at excalidraw.com
Read the method programs/book_autoresearch.md, programs/source_anchoring_pass.md, then research_passes/ for logs of what's been tried
Fork the method for your own corpus The MIT license lets you. The system isn't tied to AI Engineer — swap the source corpus and most of the machinery still applies
Star the repo ⭐ Star it if a source-anchored, panel-graded book is the way AI writing should be built — stars are how this experiment earns the right to keep running

Inspiration

  • Autoresearch (the underlying spirit — bounded research loops with self-improving instructions, originally from AI/ML research workflows)
  • Karpathy's Software 2.0 and Sutton's The Bitter Lesson (why investing in process beats investing in heroic effort)
  • Knuth's Literate Programming (the idea that the artefact is a system + its derivation, not just the output)
  • Designing Data-Intensive Applications (the editorial bar this manuscript aims at)
  • The AI Engineer practitioner community for being the corpus

License

MIT — see LICENSE. The manuscript prose is part of the experiment; if you cite or build on it, an attribution back to the experiment is appreciated but not required.


Built openly. Source-anchored. Continuously improving.

Read the book →  ·  Browse the diagrams →  ·  Inspect the method →

About

A source-anchored book on AI engineering, auto-researched from 794 practitioner talks. Every claim links to the exact second of the video it came from; every chapter is graded by a panel of three rival LLMs (no model grades its own style). Live at fromcopilottocolleague.com

Topics

Resources

License

Stars

4 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors