diff --git a/AGENTS.md b/AGENTS.md index 405fb72..d077a99 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -70,3 +70,6 @@ The independent review of the **original thirteen manuscripts** was completed an ## V3 revised full manuscripts and T1 source — pending independent re-review Read the [complete fourteen-chapter revised draft index](project/v3/manuscripts/revised/INDEX.md), [T1 source graph/data and decisions](project/v3/case-study/README.md) and [model-check note](project/v3/case-study/MODEL-CHECK.md). This collection is **14/14 draft-complete**, not independently re-reviewed or owner-approved. Use revised chapters as the **current editorial draft**, while the thirteen historical draft files remain unchanged sources. The T1 model is a synthetic toy calculation; it is not a real intersection or a qualified simulation. The editorial fixture's Node checker can be run separately, but it is not yet part of GitHub Actions. Do not publish Astro content without explicit approval. + +## Home/Learn publication — 16 November 2026 +The owner confirms initial review of the revised manuscripts and authorizes Home/Learn alignment, push and publication. Both surfaces use CourseOverview.astro, derived from project/CURRICULUM-MAP.md, with explicit GitHub manuscript links. This publishes course navigation, not V3 interactive chapter pages. Preserve existing lessons and distinguish initial owner review from independent re-review. diff --git a/site/src/components/CourseOverview.astro b/site/src/components/CourseOverview.astro new file mode 100644 index 0000000..996f78e --- /dev/null +++ b/site/src/components/CourseOverview.astro @@ -0,0 +1,33 @@ +--- +import { readFileSync, readdirSync } from 'node:fs'; +const map = readFileSync(new URL('../../../project/CURRICULUM-MAP.md', import.meta.url), 'utf8'); +const files = readdirSync(new URL('../../../project/v3/manuscripts/revised/', import.meta.url)); +const rows = map.split('\n').filter(line => /^\| (I|II|III|IV)( |\|)/.test(line)).map(line => line.split('|').slice(1,-1).map(cell => cell.trim().replaceAll('**',''))); +const parts: { title: string; chapters: { number: string; title: string; summary: string; url: string }[] }[] = []; +for (const [part, number, title, summary] of rows) { + if (part.includes('—')) parts.push({ title: part, chapters: [] }); + const file = files.find(file => file.startsWith(number + '-') && file.endsWith('.md')); + if (!file) throw new Error(`Missing revised manuscript ${number}`); + parts.at(-1)!.chapters.push({ number, title, summary, url: `https://github.com/And-Gu/executable-engineering-lab/blob/main/project/v3/manuscripts/revised/${file}` }); +} +if (parts.flatMap(part => part.chapters).length !== 14) throw new Error('Expected fourteen approved chapters'); +--- +
+

The course · Fourteen chapters

+

Follow one fictional traffic intersection from uncertain intent to an integrated product and the engineering capabilities needed to sustain it.

+

The revised manuscripts have received an initial author review. Read them on GitHub below; V3 chapter web pages and interactive experiences are still in development. The earlier published lessons remain available separately.

+ {parts.map(part =>

{part.title}

    {part.chapters.map(chapter =>
  1. )}
)} +
+ diff --git a/site/src/pages/index.astro b/site/src/pages/index.astro index 106953c..77e17f1 100644 --- a/site/src/pages/index.astro +++ b/site/src/pages/index.astro @@ -1,4 +1,5 @@ --- +import CourseOverview from '../components/CourseOverview.astro'; import HomeLayout from '../layouts/HomeLayout.astro'; import { chapters, chapterPreviews, v2Chapters } from '../data/chapters'; @@ -128,12 +129,14 @@ const featuredChapters = chapters.filter(chapter => featuredPaths.has(chapter.pa + +
-

Explore the argument

+

Earlier published lessons

{chapterPreviews.map(chapter => (
-

Chapter {chapter.number} · Preview

+

V2 · Chapter {chapter.number} · Earlier preview

Start with {chapter.title}
))} diff --git a/site/src/pages/learn/index.astro b/site/src/pages/learn/index.astro index de08dec..f72fa7c 100644 --- a/site/src/pages/learn/index.astro +++ b/site/src/pages/learn/index.astro @@ -1,22 +1,20 @@ --- import Layout from '../../layouts/Layout.astro'; import { chapters, v2Chapters, chapterPreviews } from '../../data/chapters'; -import { v2Parts } from '../../data/v2-curriculum'; +import CourseOverview from '../../components/CourseOverview.astro'; const base = import.meta.env.BASE_URL; --- -

Learn · Curriculum transition

+

Learn · Fourteen-chapter course

Develop the system. Develop how you engineer it.

Explore how executable models, software-driven workflows and AI agents change systems engineering—from an uncertain product idea to useful improvements in operation.

+
-

Start with Chapter 1

-

The opening chapter is a reader preview of the revised content and dark chapter layout.

+

Earlier Chapter 1 preview

+

This published V2 monitoring example predates the current fourteen-chapter intersection course.

{chapterPreviews.map(chapter =>

{chapter.title} →
{chapter.summary}

)}
-

V2 course structure

-

Planned curriculum. The full sequence below is planned; available v2 articles are linked separately below. Go to the published lessons for working examples.

-
{v2Parts.map(part =>

{part.title}

{part.message}

    {part.chapters.map(title =>
  1. {title}
  2. )}
)}

A shared vocabulary from Chapter 1

The Chapter 1 preview introduces systems engineering, executable engineering, software-driven workflows and AI-assisted engineering. It explains what AI agents do and distinguishes AI used in engineering from AI in products.