docs(agents): the Queen's recipe for a new 27-lesson course

[gHashTag]

Gives the Queen and every bee the recipe for opening a topic as a t27 course.

• specs/course_recipe/course-27.t27: the recipe (steps, rules, gates, cast commands; tests hold the order). Moved here from an agent-private skill folder the Queen cannot read.
• specs/course_recipe/roadmap.t27: the planned courses.
• AGENTS.md: new section "New course to open a topic" that points at both and lists the six steps.
• Blog post the-queen-knows-how-to-build-a-course (EN body + RU ruBody).

{
  "version": 1,
  "head_sha": "7b732693274278d413c38ec2a9f6b54bf6d20afe",
  "summary": "The t27 course recipe moves into the repository as two t27 modules, and AGENTS.md points the Queen at it so she can assign a 27-lesson course for any topic.",
  "changes": [
    "specs/course_recipe/course-27.t27: the course recipe as a t27 module, paths made repository-relative",
    "specs/course_recipe/roadmap.t27: the planned courses as a t27 module",
    "AGENTS.md: section New course to open a topic, a pointer, six short steps and the traps found by trinity#1470",
    "apps/website/src/data/blog: post the-queen-knows-how-to-build-a-course with English and Russian bodies"
  ],
  "tests": [
    {
      "command": "t27check (loadCompiler + runSpecTests from apps/website/scripts) on specs/course_recipe/*.t27",
      "result": "course-27.t27 clean, 7 tests 26 asserts; roadmap.t27 clean, 4 tests 30 asserts",
      "status": "passed",
      "evidence": "local run on be3747a9"
    },
    {
      "command": "tsc --noEmit in apps/website",
      "result": "rc 0, exit code 0 with no error output",
      "status": "passed",
      "evidence": "local run on the branch head 10ef548ca"
    }
  ],
  "limitations": [
    "No CI job runs the recipe's tests yet",
    "The private skill copy still exists and must be switched to point here, or the rule has two homes",
    "No new lessons ship with this PR"
  ],
  "tags": [
    "t27",
    "course",
    "agents"
  ],
  "blog": {
    "title": "The Queen now knows how to build a course",
    "summary": "The course recipe moved into the repository as t27 modules and AGENTS.md points at it.",
    "outline": [
      "The recipe for a t27 course lived in one agent's private skill folder, so the Queen and her bees could not read or assign it.",
      "It now lives in the repository as two t27 modules, the recipe itself and the roadmap of planned courses, each with its own tests.",
      "AGENTS.md gains a short section that points at them and names the shape: 9 modules of 3 lessons, one topic per course, chained.",
      "Both modules compile clean in the site's wasm compiler, with 7 and 4 tests, but no CI job runs them yet, which is the next gap."
    ]
  }
}

🤖 Generated with Claude Code

[github-actions]

X Brain Health Check

Score: 100.0/100
Status: 🟢 HEALTHY
Threshold: 80/100

X Brain is above merge threshold

[github-actions]

🧪 Brain Stress Test Results

Tests: 261/261 passed, 0 leaked
Status: 🟢 PASS
Gate: every test in zig build test-brain-stress passes and none leaks

[tri-claw]

Summary by t27-bees

Checked by the t27 compiler

_{t27c parse, parse-complete and typecheck on each changed .t27 file at c874996. Nothing was generated, built or run. A pass means the file is well formed, not that it is right.}

• specs/course_recipe/course-27.t27: parses and typechecks.
• specs/course_recipe/roadmap.t27: parses and typechecks.

Read by the model

This PR moves the t27 course recipe from a private agent folder into the repository as two tested t27 modules (course-27.t27 and roadmap.t27), adds a CI gate (check:course-recipe) that compiles and runs their tests, documents the six-step process in AGENTS.md, and publishes two blog posts.

Worth a look

• specs/course_recipe/roadmap.t27:105,109 – The test every_plan_is_nine_modules_of_three_lessons asserts PLANNED_PARTS[35] == "transformer" twice (lines 105 and 109). Harmless but redundant; one should be removed.
• apps/website/scripts/check-course-recipe.mjs:11 – fs.readdirSync(dir) will throw an uncaught exception if the directory doesn't exist (e.g., path typo or missing folder). The script only handles the empty-directory case (line 13), not the missing-directory case.
• AGENTS.md:67 – The "Traps" section tells authors to rename RU_CONTRACT and GENERATED in the copied spec, but those constants don't appear in course-27.t27 (its constants are CATALOG, TEMPLATE, GALLERY, ROADMAP, SHARE_FIRST, SHARE_NEXT). The instruction may mislead someone following the recipe.
• apps/website/scripts/check-course-recipe.mjs:17 – The gate passes only if r.tests > 0, but a module could have tests that don't actually cover the recipe steps (the work report acknowledges this limitation). The check ensures tests exist, not that they cover every step.
• apps/website/package.json:126 – The new check:course-recipe script runs with no arguments, relying on the script's hardcoded default ../../specs/course_recipe. If the script is ever moved or invoked from a different working directory, the path will resolve incorrectly.

---

_{Read: 10 files, +467 -1, the whole diff. Head c874996. Model: openai-compatible/nvidia/nemotron-3-ultra-550b-a55b. Commands: @t27-bees review | summary | help | pause | resume. Free for every repository.}