57 Commits

Author SHA1 Message Date
sanbuphy 12fc49c9cc Update What's New to feature Frontier Harness Design Breakdowns across all 15 languages
Add an August 2026 What's New entry announcing the new Frontier Harness
Design Breakdowns section (Pi, Claude Code, Codex, DeepSeek) to the English
README and all 14 translated READMEs.
2026-08-19 17:42:48 +08:00
sanbuphy 260a39938c Translate 前沿 Harness 拆解 column to all 15 languages and fix Discord link
- Add harness-designs translation files for ar, de, en, es, fr, ja, ko,
  pt-BR, ru, tr, uk, uz, vi, zh-TW (5 pages each: overview, Pi, Claude
  Code, Codex, DeepSeek)
- Wire harness-designs nav/sidebar in config.mts for all locales
- Add column cards to every language homepage
- Point Discord community link to https://github.com/walkinglabs
2026-08-19 16:46:36 +08:00
sanbuphy a703dbdd8b Add 前沿 Harness 拆解 column and remove Star History blocks
- New zh column "前沿 Harness 拆解": teardowns of Pi, Claude Code, Codex,
  and DeepSeek Harness designs with source references, mapped to the
  course's five-subsystem framework
- Wire column into zh nav, sidebar, and home page cards
- Drop Star History section from README and all 15 locale readmes
2026-08-19 15:43:50 +08:00
sanbuphy 391ed7c6b6 fix: clarify session progress and project solution setup 2026-08-04 13:35:23 +08:00
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
sanbuphy d746cb969e Move What's New / Changelog to README top 2026-07-09 02:36:23 +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
Sanbu 散步 549121baf2 Merge pull request #50 from Stephen-Kimoi/add-shell-audit-tool
feat: add zero-dependency shell audit tool (L03–L12)
2026-06-30 09:05:03 +08:00
Maksym Karnaukh f2acdb0b9b Add Ukrainian (uk) translation across the project
- Add a full Ukrainian documentation-site locale (`docs/uk/`, 90 pages:
  lectures, projects, resource library, skills) and register `uk` in the
  VitePress config (nav, sidebar, theme labels) plus the landing-page
  browser-language redirect.
- Add `docs-readme/uk-UA/README.md` (Ukrainian project README) with
  Ukrainian site screenshots, add the Ukrainian language badge to every
  README badge bar, list it in the translation index, and bump the
  language count 14 -> 15.
- Add `skills/README-UK.md` and the Ukrainian badge to the skills README
  nav bars and directory listing.
- Add Ukrainian per-project READMEs (`projects/project-0{1..6}/README-UK.md`).
- Add `skills/harness-creator/README-UK.md` and `SKILL.md.uk` (Ukrainian
  variant mirroring `SKILL.md.en`; the active `SKILL.md` is unchanged).
- Register `uk` targets in the README screenshot capture script.
- Preserve all code blocks, mermaid diagrams, and runnable examples;
  only prose is translated. Verified with `npm run docs:build`.
2026-06-25 17:43:27 +02:00
Steve Kimoi 8d7920eb21 feat: add zero-dependency shell audit tool (L03–L12)
Adds tools/audit-harness.sh — a bash script that audits any repo
against all five harness subsystems without requiring Node.js.
Complements skills/harness-creator/scripts/validate-harness.mjs
for environments where Node is unavailable or a curl-pipeable
single-command audit is preferred.
2026-06-18 11:45:22 +03:00
sanbuphy 5f5bc6137b Add Discord badge to README 2026-06-16 16:48:07 +08:00
Joris W 6b772a3c0d Update globe icon text to use emoji 2026-06-08 14:10:33 +02:00
Özgür Sarıyarlı 4b58c9ce52 fix: update language count to 14 and add missing tr/pt-BR resource links 2026-06-07 18:40:39 +03:00
Denis Balan 731792025e docs: Fix table of contents link formatting
Fix link to visual preview
2026-06-05 12:30:50 +03:00
João Paulo Fricks 0204bdac12 refactor: Update language count and list to include Portuguese (BR) 2026-06-02 22:29:32 -03:00
João Paulo Fricks a250f96ecc refactor: Update languages count in README badge 2026-06-02 17:11:38 -03:00
João Paulo Fricks d19105460b Merge branch 'main' of github.com:jpcmf/learn-harness-engineering into add-portuguese-br-translation 2026-06-01 22:09:26 -03:00
sanbuphy 52c763c627 docs: add Modern LLM Notebook course to Other Courses section 2026-06-01 08:55:25 +08:00
João Paulo Fricks 293ab800f1 Merge branch 'main' of github.com:jpcmf/learn-harness-engineering into add-portuguese-br-translation 2026-05-28 22:36:15 -03:00
Özgür Sarıyarlı 1ae5874127 fix: correct Turkish resource description from başvurular to referanslar 2026-05-28 10:52:41 +03:00
Özgür Sarıyarlı ec963de904 docs: add Turkish locale to Resource Library and repository structure 2026-05-28 08:33:53 +03:00
João Paulo Fricks 0d38b4f0bc Merge branch 'main' of github.com:jpcmf/learn-harness-engineering into add-portuguese-br-translation 2026-05-22 22:26:57 -03:00
t000@52-0B30225-05 d2850a2b8c fix: text alignment & whitespaces 2026-05-22 17:47:59 +08:00
t000@52-0B30225-05 923f59279b fix: text alignment & whitespaces 2026-05-22 17:46:22 +08:00
t000@52-0B30225-05 3ae325a902 fix: text alignment & whitespaces 2026-05-22 17:41:53 +08:00
luojiyin 4042e714ef fix: correct README table-of-contents anchor 2026-05-22 16:52:18 +08:00
João Paulo Fricks d1b1955e7a feat: Add pt-BR to language switcher 2026-05-21 18:51:10 -03: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 14024c6f2e Fix harness creator skill installation docs 2026-05-20 11:34:58 +08:00
Okan Selami 4de9127c44 Add Turkish documentation and templates for AI coding agents
- Create initializer-agent-playbook.md for initial session guidelines.
- Add method-map.md to map common error modes to solutions.
- Introduce prompt-calibration.md for defining root instructions.
- Establish AGENTS.md and CLAUDE.md templates for agent workflows.
- Implement claude-progress.md for session logging and progress tracking.
- Create clean-state-checklist.md for ensuring a clean session state.
- Add evaluator-rubric.md for assessing output quality post-session.
- Develop feature_list.json for tracking feature statuses and verification steps.
- Create index.md as a template guide for project setup.
- Implement init.sh for standard startup and verification commands.
- Add quality-document.md for assessing product area and architectural layer quality.
- Create session-handoff.md for structured session transitions.
- Introduce skills/index.md to document AI agent capabilities and harness engineering.
2026-05-18 19:16:45 +03:00
sanbuphy d0c30a12ea fix: resolve multilingual issues — language switcher, missing READMEs, badge links
- Remove duplicate `root` locale from VitePress config (was conflicting with `en`, causing language switcher to show only 6/12 languages)
- Create missing README-RU.md and README-UZ.md at root level
- Create docs-readme/ru-RU/README.md and docs-readme/uz-UZ/README.md
- Fix all README badge links for RU/UZ from live-site URLs to local file paths (19 files)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-05-15 08:41:54 +08:00
sanbuphy fb1709742f docs: expand Resource Library links to all 12 languages
Update Resource Library section in all README files to include
links for all 12 supported languages (EN, ZH, ZH-TW, JA, KO,
ES, FR, RU, DE, AR, VI, UZ).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-05-15 00:41:02 +08:00
sanbuphy 3eff765197 docs: beautify language badges and add multilingual notice
Update all README files with colorful flat-square badges for each
language. Add multilingual support notice and course stats badges
(Lectures/Projects/Languages) to the main README.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-05-15 00:30:17 +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
devtulkin 2fc22f612d docs(uz): list Uzbek in README language selectors
Add Oʻzbekcha link to the language selector across README.md,
README-CN.md, and README-KO.md so readers can discover the
new locale from any landing page.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 01:09:09 +03:00
sanbuphy 3b2d6fc80b docs: sync core references in README with detailed documentation
- Match the core reference lists in  and  with the newly updated  and .
- Replace older extended references with the new core articles from LangChain, Martin Fowler, and Cursor.
2026-05-05 19:42:18 +08:00
sanbuphy 5dd49b239e docs: add star history chart 2026-05-05 09:57:20 +08:00
sanbuphy 2de08fa5a1 docs: update harness reference articles 2026-05-05 09:55:44 +08:00
sanbuphy 146a23b4c1 docs: add table of contents, skills section, and other courses to READMEs 2026-05-04 10:08:40 +08:00
Teddy Lee e492130d4b feat(docs): add Korean (ko) locale with full translation
## What Changed
- Added 90 mirrored Korean docs under docs/ko/ (lectures 12, projects 6,
  resources/templates, reference, openai-advanced, skills)
- Created Korean glossary at docs/ko/resources/reference/glossary.md as
  single source of truth for term consistency
- Added 8 Korean READMEs: README-KO.md, skills/README-KO.md,
  projects/project-{01..06}/README-KO.md
- Extended docs/.vitepress/config.mts with koLectureItems, koProjectItems,
  koResourceItems, koSkillItems and a `ko` locale block (mirrors the
  zh/ru/vi pattern)
- Generalized docs/index.md auto-redirect to explicit 5-language matching
  (ko/zh/ru/vi -> respective folders, others -> en); fixes prior
  ru/vi fallback regression as a side effect
- Added 한국어 link to existing language selectors in README.md, README-CN.md,
  skills/README.md, skills/README-CN.md

## Root Cause
The repo supports en/zh/ru/vi but Korean learners had no localized path.
Plan: ~/.claude/plans/repository-lucky-sundae.md

## Solution Approach
- Mirror docs/en directory layout 1:1 into docs/ko (paths/slugs stay English)
- First-occurrence bilingual notation: 한국어(English) per glossary
- 격식체 tone, no emoji, system tokens (BLOCKING/HARD/[CP]/@agent/Skill())
  preserved untranslated
- Add 1-2 sentences of pedagogical background per new concept

## Test Plan
- [x] `npm run docs:build` exit 0
- [x] No "dead link" output in build log
- [x] `diff <(en tree) <(ko tree)` returns only docs/ko/resources/reference/glossary.md
      (Korean-only artifact, plan-mandated)
- [x] Emoji scan (PCRE2 + ZWJ/VS16/keycap/flag) returns 0 matches
- [x] All 5 READMEs contain "한국어" link
- [x] No Korean characters in any frontmatter key
- [x] Protected tokens preserved (11 instances of @agent/BLOCKING/HARD)
- [x] All 12 lectures pass `한국어(English)` regex >=1 occurrence

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-30 04:11:46 +09:00
sanbuphy 03cbc19015 style: remove redundant Chinese README link from language selector
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-29 09:51:06 +08:00
sanbuphy 9d54a1fc89 style: move language selector to top of README
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-29 09:47:19 +08:00
sanbuphy 6863a7d01d style: display docs languages as horizontal link list in README
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-29 09:43:07 +08:00
sanbuphy b8ba3540fe docs: add Russian and Vietnamese language support to README
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-29 09:41:25 +08:00
sanbuphy 92c1588e15 docs: refine README visual preview descriptions based on actual screenshot content 2026-04-04 01:49:34 +08:00
sanbuphy 14118b95b6 refactor: move .opencode/skills to top-level skills/, remove skill-creator, add Skills to docs site
- Move .opencode/skills/harness-creator/ → skills/harness-creator/
- Remove skill-creator (third-party, now referenced via link to anthropics/skills)
- Add skills/ README.md (EN) and README-CN.md (ZH) with security audit notes
- Add VitePress skills pages (docs/en/skills/, docs/zh/skills/)
- Add Skills/技能 nav item to both EN and ZH site navigation
- Update root README.md and README-CN.md with quick start note and skills/ in repo tree

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-04 01:33:53 +08:00
sanbuphy c491d171f5 Refine README screenshots and lecture 01 diagrams 2026-04-03 00:50:02 +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 f90e952e6e docs: sync readme with professional harness engineering tone and site links 2026-04-02 12:22:47 +08:00
sanbuphy 2363346e28 Update acknowledgments wording and refresh CLAUDE.md
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-31 10:36:49 +08:00