Add CI for demos and link checks, curator section, live badges

Author: TheSeydiCharyyev

.github/workflows/demos.yml

@@ -0,0 +1,29 @@
+name: demos
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  run:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node: [18, 20, 22]
+    name: node ${{ matrix.node }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node }}
+      - name: "MCP server + client (§5)"
+        run: node reference/05-mcp-server-client/mcp-client.mjs | grep -F "add(2, 3) -> 5"
+      - name: "Coding agent (§6)"
+        run: node reference/06-coding-agent/example.mjs | grep -F "final: Created greet.txt"
+      - name: "Token accounting (§7)"
+        run: node reference/07-token-accounting/example.mjs | grep -F "cache saved:"

.github/workflows/links.yml

@@ -0,0 +1,31 @@
+name: links
+
+on:
+  push:
+    branches: [main]
+    paths: ["**/*.md"]
+  schedule:
+    - cron: "0 6 * * 1" # weekly, Monday 06:00 UTC
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Check every curated link
+        uses: lycheeverse/lychee-action@v2
+        with:
+          # 403/429 accepted: Medium/YouTube-class hosts bot-block automated
+          # requests while the pages are fine in a browser.
+          args: >-
+            --no-progress
+            --max-retries 2
+            --max-concurrency 4
+            --accept '100..=103,200..=299,403,429'
+            --exclude-all-private
+            README.md CONTRIBUTING.md 'reference/**/*.md'
+          fail: true

README.md

@@ -5,10 +5,9 @@
 </p>
 
 <p align="center">
-  <img alt="stars" src="https://img.shields.io/github/stars/TheSeydiCharyyev/build-your-own-agent?style=social">
+  <a href="https://github.com/TheSeydiCharyyev/build-your-own-agent/actions/workflows/demos.yml"><img alt="demos" src="https://github.com/TheSeydiCharyyev/build-your-own-agent/actions/workflows/demos.yml/badge.svg"></a>
+  <a href="https://github.com/TheSeydiCharyyev/build-your-own-agent/actions/workflows/links.yml"><img alt="links" src="https://github.com/TheSeydiCharyyev/build-your-own-agent/actions/workflows/links.yml/badge.svg"></a>
   <img alt="license" src="https://img.shields.io/badge/license-MIT-blue">
-  <img alt="PRs welcome" src="https://img.shields.io/badge/PRs-welcome-brightgreen">
-  <img alt="status" src="https://img.shields.io/badge/status-v1-brightgreen">
 </p>
 
 ---
@@ -22,7 +21,7 @@ git clone https://github.com/TheSeydiCharyyev/build-your-own-agent
 node build-your-own-agent/reference/06-coding-agent/example.mjs
 ```
 
-A coding agent writes a file, reads it back, and verifies itself — zero dependencies, no API key. Then open [`agent.mjs`](reference/06-coding-agent/agent.mjs): the entire loop fits on one page.
+A coding agent writes a file, reads it back, and verifies itself — zero dependencies, no API key, Node 18+. Then open [`agent.mjs`](reference/06-coding-agent/agent.mjs): the entire loop fits on one page.
 
 ## Why this exists
 
@@ -38,6 +37,12 @@ There are already excellent **from-scratch courses** — one author, one linear
 - **A living map, not a frozen curriculum.** The field moves monthly. A 500-lesson course ossifies; an index swaps one link and stays current. Quality is gatekept like a real `awesome` list.
 - **Own reference implementations where the gaps are.** For the components with no good from-scratch resource, this repo ships its own minimal code — the part you can't get by linking to someone else's course.
 
+## Who curates this
+
+I'm [Seydi](https://github.com/TheSeydiCharyyev) — an OSS contributor with merged PRs in [Storybook](https://github.com/storybookjs/storybook) (org member), [goose](https://github.com/block/goose), and [Supabase](https://github.com/supabase/supabase-js). §7 grew out of building [quotaburn](https://github.com/TheSeydiCharyyev/quotaburn), a token-cost CLI on npm.
+
+Method: every link is fetched and read, and every reference demo is run, before it enters the index — CI re-verifies both (badges above).
+
 ## The stack
 
 | # | Component | Curated | Reference impl |