26 Commits

Author SHA1 Message Date
sanbuphy 79450b0729 Add Graph Engineering lecture and project across all 15 locales
Introduce Lecture 14 (From Single Loops to Graph Engineering) and Project 08
(Draw Your Workflow as a Graph), translated into all 15 locales. Update the
sidebar config, per-locale READMEs (what's-new blocks, learning path phases
7-8, project evolution, and outline links pointing to each locale's docs),
and the root/zh-CN READMEs.

Key content: the four stacked layers (prompt to context to loop to graph) and
where harness sits, the four parts of a graph, why in-loop checkpoints can't
fix the three structural failures at scale, a framework-agnostic six-step
build walkthrough, graph vs. workflow, anchors, and the open-source
landscape before vs. after the name.
2026-08-04 11:22:54 +08:00
Alec Chen 5f3fce9e47 Fix broken HumanLayer link across all 15 locales
The old link https://humanlayer.dev/articles/harness-engineering-for-coding-agents/
returns 404. Updated to https://www.humanlayer.dev/blog/skill-issue-harness-engineering-for-coding-agents
across all locales (lectures 01, 02, 04, 05, 06).

The new page title ('Skill Issue: Harness Engineering for Coding Agents')
matches the link text used in lecture-01. The short link text used in
lectures 02/04/05/06 ('HumanLayer: Harness Engineering for Coding Agents')
is a subset of the same title, so no display text changes needed.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-30 21:43:40 +08:00
sanbuphy a1db89298f Add Lecture 13 + Project 07: Loop Engineering
新增 Lecture 13(从手动驱动到自动循环)和 Project 07(搭建你的第一个自动循环)。

核心内容:
- L13: 从 /goal 到六原语,generator/evaluator 分离,四种沉默成本,从零搭建第一个 loop
- P07: 三个递进实验 — goal loop、timer loop、maker-checker loop
- 配套代码模板:goal-template.md、loop-state-template.md、maker-prompt.md、checker-prompt.md
- Reference 页新增 Addy Osmani Loop Engineering (2026-06-07) 到 2026 扩展参考
- README 更新徽章(13 lectures / 7 projects),学习路径图、syllabus、project 表格、changelog

Build: ✓
2026-07-09 02:04:30 +08:00
sanbuphy 2fdc46b20a Fix broken Goodreads link for "How Google Tests Software"
The Goodreads URL (book/show/13563030) redirected to the wrong book.
Replace it with the Google Books link to the correct title across all
15 language editions of lecture-08 and lecture-10 (30 files total).
2026-06-30 09:32:59 +08:00
sanbuphy 66003acd1c refactor: 润色第六、七讲章节标题为课本风格 2026-05-28 11:34:14 +08:00
sanbuphy daa0fa1690 refactor: 统一第六至十一讲章节标题为课本风格,去除口语化表达 2026-05-28 11:30:02 +08:00
sanbuphy 6bfd2332be refactor: 统一第六至十一讲语调,去除"而不是/而是"句式,改为教材式直接叙述 2026-05-28 11:23:43 +08:00
sanbuphy e9d6fb7848 refactor: 润色第十二讲,统一教材语气,去除口语化表达和转折句式 2026-05-28 11:15:27 +08:00
sanbuphy b030de783e Fix awkward translated terms in both Chinese and English lectures
Replace stiff English-to-Chinese calques with natural Chinese phrasing:
- 自举契约 → 启动就绪清单 (bootstrap contract → startup readiness checklist)
- 冷启动测试 → 全新会话测试 (cold start test → fresh session test)
- 连续性工件 → 状态持久化文件 (continuity artifact → state persistence file)
- 中间迷失效应 → 长文本中间信息容易被忽略
- 路由文件 → 入口文件 (router file → entry file)
- 渐进式披露 → 按需展开 (progressive disclosure → reveal on demand)
- And 8 more term fixes across lectures 01-06

Also: standardize summary section header to 核心要点 / Key Takeaways,
add structured bullet points with bold labels to Lecture 01 failure modes.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-23 13:14:07 +08:00
sanbuphy 8692fae32f Polish lecture formatting: standardize section headers and add structure
- Rename summary section from "带走什么"/"关键要点" to "核心要点" across
  all 12 Chinese lectures for consistency
- Add bullet points and bold labels to Lecture 01 failure modes section
  for better scannability

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-23 12:58:19 +08:00
sanbuphy b6997546f4 Rewrite all lecture prose to remove AI-sounding tone
The Chinese lecture text had a heavy "AI listing bullet points" feel —
excessive em-dashes, forced analogies on every paragraph, rhetorical
patterns like "this is not X, but rather Y", and bullet-point summaries
that read like model output. This commit rewrites the narrative sections
of all 12 Chinese lectures in a more natural, conversational tone, then
re-translates the 12 English lectures to match the polished Chinese versions.

Key changes:
- Remove repetitive analogies (restaurant ordering, carpenter, exam papers,
  choir rehearsal, dorm room, etc.) — keep at most one per lecture
- Reduce em-dash usage, favor commas and periods
- Rewrite "core concepts" definitions in natural prose
- Make "key takeaways" sections feel less like model-generated summaries
- Align English versions with the rewritten Chinese structure

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-23 12:54:10 +08:00
yuzhiquan 3bc7009672 fix: repair 298 broken relative links across all markdown files
Docs were restructured to add a language layer (docs/en/...) but links
in README, docs-readme locales, and projects still pointed to the old
paths (docs/lectures/, docs/projects/). Also convert three non-existent
example file references in lecture-04 to plain text.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-21 16:58:51 +08:00
sanbuphy 4f2cb1c892 Clarify harness ablation diagnostics 2026-05-20 11:20:45 +08:00
sanbuphy c66d0c3272 Clarify harness terminology across languages 2026-05-19 17:54:43 +08:00
sanbuphy e38d69701e docs: complete multilingual translations for all 11 locales
Translate all remaining English placeholder content across ar, de, es, fr, ja, ko, ru, uz, vi, zh, zh-TW locales. Includes lecture index files, code examples, templates, references, and skills docs.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-05-15 00:20:06 +08:00
BlingDan c8d992784d docs(zh): fix typo in lecture 01 title 2026-05-11 11:06:52 +08:00
sanbuphy aace33eecf docs: clarify distinction between core concepts and five failure layers
- Renamed 'Core Concepts' section to 'Key Terminology' to prevent structural confusion

- Replaced ambiguous 'above' reference with explicit list of the five defense layers

- Applied fixes across all language versions (en, zh, ru, vi)
2026-04-29 10:09:13 +08:00
sanbuphy 01024a9957 Rewrite lecture narratives for natural, conversational tone
- Rewrite all 12 Chinese lectures with warmer, more engaging prose
- Remove rigid "四种/五种 xxx" numbered list patterns
- Vary narrative structure across lectures instead of uniform template
- Sync English translations to match new Chinese content
- Keep mermaid diagrams, code blocks, exercises, and references intact

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-03 02:30:51 +08:00
sanbuphy c491d171f5 Refine README screenshots and lecture 01 diagrams 2026-04-03 00:50:02 +08:00
sanbuphy fbc6d1f60e Improve Mermaid diagrams and viewer UX 2026-04-03 00:18:56 +08:00
sanbuphy 67dfa5937e Add mermaid diagrams to all lectures, PDF build pipeline, and README screenshots
- Add 1-2 mermaid diagrams per lecture (EN + ZH, 24 files total) illustrating
  core concepts: five-layer failure model, harness subsystems, knowledge visibility,
  instruction architecture, session continuity, initialization lifecycle, WIP=1
  workflow, feature state machine, termination checks, test pyramid, observability
  layers, and clean state dimensions
- Add PDF build pipeline: scripts/build-course-pdfs.ts and npm scripts
- Add README screenshot capture script and workflow
- Add GitHub Actions workflow for automated PDF releases
- Update README/README-CN with screenshots and PDF documentation

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-02 17:45:03 +08:00
sanbuphy 47dc3484a6 Fix docs links for GitHub Pages routes 2026-04-02 13:25:27 +08:00
sanbuphy 9c024353fa Add code links and project cross-links to all lectures and projects
- Copy code/ directories from zh lectures to en lectures (12 dirs)
- Add code example GitHub links + project links to all 12 CN lectures
- Add code example GitHub links + project links to all 12 EN lectures
- Add related lecture links + template GitHub links to all 6 CN projects
- Add related lecture links + template GitHub links to all 6 EN projects

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-01 01:05:38 +08:00
sanbuphy 9028dd17c6 Add source links to supplemented lecture content
All factual claims verified against original articles:
- OpenAI: Harness engineering (Feb 2026) — all 8 claims confirmed
- Anthropic: Effective harnesses (Nov 2025) — all claims confirmed
- Anthropic: Harness design (Mar 2026) — all 7 claims confirmed

Add > source citation links to L01, L05, L09, L10, L11, L12.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-31 12:27:18 +08:00
sanbuphy 9b0a495750 Supplement 6 lectures with missing source article content
Cover concepts that were previously missing or incomplete from the
three reference articles (OpenAI harness engineering + Anthropic
long-running agents + Anthropic harness design):

- L01: Add OpenAI's empty-repo experiment (0 human-written lines,
  1M+ agent-generated lines, 1500 PRs, 3 engineers)
- L05: Deepen context anxiety analysis with Sonnet 4.5 vs Opus 4.5
  data, compaction vs reset trade-offs
- L09: Add self-evaluation bias and generator-evaluator separation
  with DAW experiment cost comparison table
- L10: Add layered domain architecture enforcement and custom
  lint patterns from OpenAI's Codex practice
- L11: Add three-agent architecture with detailed phase timing
  and cost data from Anthropic's DAW experiment
- L12: Add golden principles, garbage collection cycle, harness
  simplification as models improve (Opus 4.6), and high-throughput
  merge philosophy

Also fix root index.md to auto-redirect based on browser language.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-31 12:14:02 +08:00
sanbuphy 42725d040f Reorganize docs: zh/en as sibling directories with language chooser
Restructure documentation from mixed layout (root=Chinese, /en/=English)
to clean zh/en split with a root language chooser page:

docs/
├── index.md          # Language chooser (zh/en)
├── zh/               # Complete Chinese content
│   ├── lectures/     # 12 lectures with code examples
│   ├── projects/     # 6 projects
│   └── resources/    # Templates, references, advanced pack
└── en/               # Complete English content
    ├── lectures/     # 12 lectures
    ├── projects/     # 6 NEW English project pages
    └── resources/    # Moved from resources/en/

Changes:
- Move Chinese lectures/projects/resources into docs/zh/
- Move English resources into docs/en/resources/
- Create 6 English project pages with cross-links
- Delete orphaned docs/zh/ ghost directory
- Rewrite VitePress config for zh/en locale split
- Fix all cross-links across 30+ files

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-31 11:06:53 +08:00