team

.coderabbit.yaml

@@ -0,0 +1,6 @@
+reviews:
+  high_level_summary: false
+  poem: false
+  changelog: false
+  release_notes: false
+  collapse_walkthrough: true

.github/FUNDING.yml

@@ -1 +1,2 @@
 github: [rohitg00]
+custom: ["https://github.com/rohitg00/ai-engineering-from-scratch/blob/main/SPONSORS.md"]

.github/workflows/curriculum.yml

@@ -0,0 +1,117 @@
+name: curriculum
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "phases/**"
+      - "scripts/audit_lessons.py"
+      - "scripts/build_catalog.py"
+      - "scripts/check_readme_counts.py"
+      - "catalog.json"
+      - "README.md"
+      - ".github/workflows/curriculum.yml"
+  pull_request:
+    branches: [main]
+    paths:
+      - "phases/**"
+      - "scripts/audit_lessons.py"
+      - "scripts/build_catalog.py"
+      - "scripts/check_readme_counts.py"
+      - "catalog.json"
+      - "README.md"
+      - ".github/workflows/curriculum.yml"
+
+permissions:
+  contents: read
+
+jobs:
+  audit:
+    name: invariant checks
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5  # v4
+        with:
+          persist-credentials: false
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065  # v5
+        with:
+          python-version: "3.12"
+      - name: run scripts/audit_lessons.py
+        run: python3 scripts/audit_lessons.py
+
+  catalog-sync:
+    name: catalog.json auto-regen (main only)
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    if: github.event_name == 'push'
+    steps:
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5  # v4
+        with:
+          ref: ${{ github.ref }}
+          token: ${{ secrets.GITHUB_TOKEN }}
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065  # v5
+        with:
+          python-version: "3.12"
+      - name: rebuild catalog.json
+        run: python3 scripts/build_catalog.py
+      - name: sync README counts
+        run: python3 scripts/check_readme_counts.py --fix
+      - name: commit + push if changed
+        env:
+          BOT_COMMIT_PREFIX: "chore(catalog): auto-regen"
+        run: |
+          if git diff --quiet catalog.json README.md; then
+            echo "catalog.json and README.md already in sync"
+            exit 0
+          fi
+          last_msg=$(git log -1 --pretty=%s)
+          if [[ "$last_msg" == "$BOT_COMMIT_PREFIX"* ]]; then
+            echo "last commit was already a bot regen; not pushing to avoid loop"
+            exit 0
+          fi
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git add catalog.json README.md
+          git commit -m "$BOT_COMMIT_PREFIX"
+          git push
+
+  catalog-drift-advisory:
+    name: catalog.json drift advisory
+    runs-on: ubuntu-latest
+    if: github.event_name == 'pull_request'
+    steps:
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5  # v4
+        with:
+          persist-credentials: false
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065  # v5
+        with:
+          python-version: "3.12"
+      - name: rebuild catalog
+        run: python3 scripts/build_catalog.py --out /tmp/catalog.fresh.json
+      - name: diff against committed catalog.json
+        run: |
+          if ! diff -u catalog.json /tmp/catalog.fresh.json; then
+            echo "::warning::catalog.json drift detected. Main will self-heal on merge via the catalog-sync job."
+          else
+            echo "catalog.json matches filesystem"
+          fi
+
+  readme-counts-drift:
+    name: README.md counts drift advisory
+    runs-on: ubuntu-latest
+    if: github.event_name == 'pull_request'
+    steps:
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5  # v4
+        with:
+          persist-credentials: false
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065  # v5
+        with:
+          python-version: "3.12"
+      - name: rebuild catalog
+        run: python3 scripts/build_catalog.py
+      - name: check README counts against catalog.json
+        run: |
+          if ! python3 scripts/check_readme_counts.py; then
+            echo "::warning::README.md counts drift detected. Main will self-heal on merge via the catalog-sync job."
+          fi

.gitignore

@@ -53,3 +53,6 @@ mlruns/
 *.bin
 *.h5
 .gstack/
+
+.link-cache.json
+.claude/

CONTRIBUTING.md

@@ -1,6 +1,26 @@
-# Contributing to AI Engineering from Scratch
+# Contributing
 
-Thank you for wanting to make AI education better for everyone.
+Lessons, translations, fixes, outputs — all welcome. One contribution per pull
+request keeps reviews fast and lets contributor counts and credit work
+correctly.
+
+## Important: the README and ROADMAP feed the website
+
+`site/build.js` parses `README.md`, `ROADMAP.md`, and `glossary/terms.md` to
+generate `site/data.js`. Two patterns must stay intact in any pull request that
+touches those files:
+
+- Phase headers in either `### Phase N: Name \`X lessons\`` form or
+  `<details><summary><b>Phase N — Name</b> ... <code>X lessons</code> ... <em>Description</em></summary>` form.
+- Lesson tables with the column shape `| # | Lesson | Type | Lang |` (or
+  `| # | Project | Combines | Lang |` for capstone tables). The `Lang` column
+  accepts plain text (`Python, TypeScript`) or the legacy emoji flags
+  (`🐍 🟦 🦀 🟣 ⚛️`); both are parser-equivalent.
+- ROADMAP status glyphs (`✅`, `🚧`, `⬚`) on phase headers and lesson rows.
+  Do not replace them with text — the parser keys off the exact characters.
+
+Run `node site/build.js` after editing those files; `git diff site/data.js`
+should show only the timestamp change if your edit was structural-safe.
 
 ## Ways to Contribute
 
@@ -133,3 +153,11 @@ More exercises and projects are always welcome, especially ones that connect mul
 ## Code of Conduct
 
 See [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md). Be kind, be helpful, be constructive.
+
+## Style
+
+- Direct prose. Cut filler. Match the manual's tone, not marketing copy.
+- No decorative emojis in headings. Lang column emoji flags are the one
+  exception and only because the parser maps them.
+- Code runs as-is with the dependencies listed in the lesson.
+- Build from scratch first, framework second.