Commit Graph

31 Commits

Author SHA1 Message Date
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 1ebca824ac Refine nav locale and sidebar behavior 2026-04-02 15:28:01 +08:00
sanbuphy 3d43460837 Improve sidebar wrapping and GitHub link 2026-04-02 14:51:26 +08:00
sanbuphy b1200ea84d Refine docs logo styling 2026-04-02 14:43:04 +08:00
sanbuphy dd29a75546 Fix docs navigation and branding issues 2026-04-02 14:39:38 +08:00
sanbuphy 47dc3484a6 Fix docs links for GitHub Pages routes 2026-04-02 13:25:27 +08:00
sanbuphy ab7d299261 style: replace text redirecting with a spinner 2026-04-02 12:32:37 +08:00
sanbuphy f90e952e6e docs: sync readme with professional harness engineering tone and site links 2026-04-02 12:22:47 +08:00
sanbuphy 8733a398db feat: add Try Harness action button to navbar 2026-04-02 12:14:37 +08:00
sanbuphy 1961fff00d docs: add mermaid support and update index pages 2026-04-02 12:08:11 +08:00
sanbuphy a7f05ab505 style: refactor docs theme to match anthropic/claude style 2026-04-02 11:46:53 +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 a924ad6d0e Fix duplicate Chinese locale in language switcher 2026-03-31 18:52:43 +08:00
sanbuphy e66e534b63 Fix homepage language redirect for GitHub Pages 2026-03-31 13:36:55 +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 b68a098fc7 Fix root locale: add root config for VitePress landing page
The root / page had no locale config, causing missing theme/nav.
Add root locale with links to /zh/ and /en/.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-31 11:36:32 +08:00
sanbuphy 3850f3c5fd Fully localize Chinese README: translate all code blocks, diagrams, and links
- Translate all ASCII diagrams to Chinese (harness pattern, five subsystems,
  with/without comparison, learning path, project evolution, session lifecycle)
- Translate code block comments and labels
- Update all links to new zh/ locale paths
- Add project evolution diagram and detailed project table
- Fix resource links to match new zh/en directory structure

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-31 11:14:06 +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
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
sanbuphy d96cb507de Polish READMEs with ASCII diagrams, detailed structure, and acknowledgments
Add text-based flowcharts for harness pattern, five subsystems,
with/without comparison, learning path, project evolution, and session
lifecycle. Add learn-claude-code acknowledgment to both EN and CN versions.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-31 10:17:51 +08:00
sanbuphy 592e805af1 Update lectures, add code examples, and enhance docs 2026-03-31 09:52:47 +08:00
sanbuphy e8e1c5d652 Polish Chinese docs and resource translations 2026-03-30 18:34:04 +08:00
sanbuphy b6fcf3849d Fix docs routes and restore dead-link checks 2026-03-30 18:21:59 +08:00
sanbuphy 6f8ffe2d57 Migrate docs into docs/ and consolidate resources 2026-03-30 18:04:41 +08:00
sanbuphy c70d6fa31f Add docs resource library and OpenAI advanced pack 2026-03-30 17:25:01 +08:00
sanbuphy ec0a6d2a3e Expand course guidance and add quality document template 2026-03-30 15:36:11 +08:00
sanbuphy c098f3ffec Add GitHub Pages deployment workflow 2026-03-30 14:50:55 +08:00
sanbuphy 4148f9808d Add bilingual resource library and starter templates 2026-03-30 14:37:43 +08:00
sanbuphy 28f9413d69 Refine lecture handouts and project briefs 2026-03-30 09:20:38 +08:00
sanbuphy 7219a1e3fc Initialize course structure and docs site 2026-03-30 00:15:54 +08:00