Skip to content

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

Open
gHashTag wants to merge 6 commits into
mainfrom
docs/agents-course-recipe
Open

gHashTag wants to merge 6 commits into
mainfrom
docs/agents-course-recipe

Conversation

@gHashTag

@gHashTag gHashTag commented Oct 7, 2026 •

Copy link
Copy Markdown
Owner

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

Move the course-27 recipe into specs/course_recipe as two t27 modules and
point AGENTS.md at them, with the blog post for this PR.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…m it

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@github-actions

github-actions Bot commented Oct 7, 2026

Copy link
Copy Markdown
Contributor

X Brain Health Check

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

X Brain is above merge threshold

@github-actions github-actions Bot added the status:in-progress 🔵 Agent working label Oct 7, 2026
gHashTag and others added 2 commits October 7, 2026 19:36
…s of 1

The owner's rule was 9 modules of 3 lessons (27 lessons); the recipe had
flattened it to 27x1. Constants, tests, roadmap and the AGENTS.md section
now say 9x3; the roadmap's 9 parts per course are the 9 modules.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…cipe

# Conflicts:
#	apps/website/src/data/blog/index.ts
#	apps/website/src/data/blog/posts.ts
@github-actions

github-actions Bot commented Oct 7, 2026

Copy link
Copy Markdown
Contributor

🧪 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

gHashTag and others added 2 commits October 8, 2026 11:20
…cipe

# Conflicts:
#	apps/website/src/data/blog/index.ts
#	apps/website/src/data/blog/posts.ts
The main-first + head-after union of the post registries kept both sides
but dropped the array/object closers that sat between the two conflict
fragments, so the next entry's slug: line parsed as a string inside the
previous ru.openQuestions array. tsc -b reports 12 syntax errors; the
typecheck ratchet refuses the file (0 -> 12). The seam gets the four
closing lines a healthy entry boundary already carries.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

status:in-progress 🔵 Agent working

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant