How nexu-io/harness-engineering-guide works
This repository is a bilingual, article-based guide to AI-agent harness engineering, published through a Next.js site. Readers enter through a landing page or navigation, browse a topic or changelog, and read rendered Markdown with article navigation and a table of contents. The README documents broad subject areas—agent loops, tools, memory, safety, orchestration, evaluation, and deployment patterns—which are represented as content branches rather than runtime harness components. Source excerpts show the English page and content-rendering path; several other documented branches are represented at their exact content directories because their implementations were not sampled.
Main entry points: [slug]/page.tsx Guide article route · app/page.tsx Guide homepage · content.ts Markdown loader · guide-data.ts Guide navigation data
Components 21
Website experience
- Guide homepage
site/app/page.tsx - Guide introduction
site/components/Hero.tsx - Guide article route
site/app/guide/[slug]/page.tsx - Article layout
site/components/ArticleLayout.tsx - Contents navigation
site/components/TableOfContents.tsx - Changelog page
site/app/changelog/page.tsx - Markdown loader
site/lib/content.ts - Guide navigation data
site/lib/guide-data.ts - Site navigation
site/components/Navigation.tsx - Shared site shell
site/app/layout.tsx
Guide content
- Harness fundamentals
guide - Production patterns
guide - Evaluation and research
guide - Engineering showcases
guide
Chinese edition
- Chinese homepage
site/app/zh/page.tsx - Chinese article route
site/app/zh/guide/[slug]/page.tsx - Chinese changelog
site/app/zh/changelog/page.tsx - Chinese guide articles
zh-guide
Packaged skill
- Abuse hunter skill
skills/abuse-hunter/SKILL.md - Abuse analysis script
skills/abuse-hunter/scripts/analyze.py
Other components
- Reader
Connections 23
- Reader → Guide homepage: opens
README.md - Guide homepage → Guide introduction: renders
site/app/page.tsx - Guide homepage → Guide navigation data: uses sections
site/app/page.tsx - Reader → Guide article route: opens article
README.md - Guide article route → Markdown loader: loads article
site/app/guide/[slug]/page.tsx - Guide article route → Guide navigation data: uses ordering
site/app/guide/[slug]/page.tsx - Guide article route → Article layout: renders article
site/app/guide/[slug]/page.tsx - Article layout → Contents navigation: renders headings
site/components/ArticleLayout.tsx - Reader → Changelog page: opens updates
README.md - Changelog page → Markdown loader: loads entries
site/app/changelog/page.tsx - Shared site shell → Site navigation: renders
site/app/layout.tsx - Reader → Chinese homepage: opens Chinese edition
README.md - Chinese homepage → Guide navigation data: uses sections
site/app/zh/page.tsx - Reader → Chinese article route: opens Chinese article
site/app/zh/guide/[slug]/page.tsx - Reader → Chinese changelog: opens Chinese updates
site/app/zh/changelog/page.tsx - Chinese changelog → Markdown loader: loads entries
site/app/zh/changelog/page.tsx - Reader → Harness fundamentals: studies
README.md - Reader → Production patterns: studies
README.md - Reader → Evaluation and research: studies
README.md - Reader → Engineering showcases: reads
README.md - Reader → Chinese guide articles: reads
README.md - Reader → Abuse hunter skill: uses
- Abuse hunter skill → Abuse analysis script: runs