# nexu-io/harness-engineering-guide architecture

> Architecture diagram of the GitHub repository nexu-io/harness-engineering-guide, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nexu-io/harness-engineering-guide
- Repository: https://github.com/nexu-io/harness-engineering-guide

## Overview

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: [`site/app/guide/[slug]/page.tsx`](https://github.com/nexu-io/harness-engineering-guide/blob/main/site/app/guide/%5Bslug%5D/page.tsx) (Guide article route), [`site/app/page.tsx`](https://github.com/nexu-io/harness-engineering-guide/blob/main/site/app/page.tsx) (Guide homepage), [`site/lib/content.ts`](https://github.com/nexu-io/harness-engineering-guide/blob/main/site/lib/content.ts) (Markdown loader), [`site/lib/guide-data.ts`](https://github.com/nexu-io/harness-engineering-guide/blob/main/site/lib/guide-data.ts) (Guide navigation data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Website experience"]
  node_home["Guide homepage<br/>[page.tsx]"]
  node_hero["Guide introduction<br/>[Hero.tsx]"]
  node_guide_route["Guide article route<br/>[page.tsx]"]
  node_article_layout["Article layout<br/>[ArticleLayout.tsx]"]
  node_toc["Contents navigation"]
  node_changelog["Changelog page<br/>[page.tsx]"]
  node_content_loader["Markdown loader<br/>[content.ts]"]
  node_guide_index["Guide navigation data<br/>[guide-data.ts]"]
  node_navigation["Site navigation<br/>[Navigation.tsx]"]
  node_shell["Shared site shell<br/>[layout.tsx]"]
end

subgraph group_content["Guide content"]
  node_harness_topics["Harness fundamentals"]
  node_production_topics["Production patterns"]
  node_evaluation_topics["Evaluation and research"]
  node_showcases["Engineering showcases"]
end

subgraph group_locales["Chinese edition"]
  node_zh_home["Chinese homepage<br/>[page.tsx]"]
  node_zh_guide["Chinese article route<br/>[page.tsx]"]
  node_zh_changelog["Chinese changelog<br/>[page.tsx]"]
  node_zh_articles["Chinese guide articles"]
end

subgraph group_skills["Packaged skill"]
  node_skill["Abuse hunter skill<br/>[SKILL.md]"]
  node_skill_analyzer["Abuse analysis script<br/>[analyze.py]"]
end

node_reader(("Reader"))

node_reader -->|"opens"| node_home
node_home -->|"renders"| node_hero
node_home -->|"uses sections"| node_guide_index
node_reader -->|"opens article"| node_guide_route
node_guide_route -->|"loads article"| node_content_loader
node_guide_route -->|"uses ordering"| node_guide_index
node_guide_route -->|"renders article"| node_article_layout
node_article_layout -->|"renders headings"| node_toc
node_reader -->|"opens updates"| node_changelog
node_changelog -->|"loads entries"| node_content_loader
node_shell -->|"renders"| node_navigation
node_reader -->|"opens Chinese edition"| node_zh_home
node_zh_home -->|"uses sections"| node_guide_index
node_reader -->|"opens Chinese article"| node_zh_guide
node_reader -->|"opens Chinese updates"| node_zh_changelog
node_zh_changelog -->|"loads entries"| node_content_loader
node_reader -->|"studies"| node_harness_topics
node_reader -->|"studies"| node_production_topics
node_reader -->|"studies"| node_evaluation_topics
node_reader -->|"reads"| node_showcases
node_reader -->|"reads"| node_zh_articles
node_reader -.->|"uses"| node_skill
node_skill -.->|"runs"| node_skill_analyzer

click node_home "https://github.com/nexu-io/harness-engineering-guide/blob/main/site/app/page.tsx"
click node_hero "https://github.com/nexu-io/harness-engineering-guide/blob/main/site/components/Hero.tsx"
click node_guide_route "https://github.com/nexu-io/harness-engineering-guide/blob/main/site/app/guide/%5Bslug%5D/page.tsx"
click node_article_layout "https://github.com/nexu-io/harness-engineering-guide/blob/main/site/components/ArticleLayout.tsx"
click node_toc "https://github.com/nexu-io/harness-engineering-guide/blob/main/site/components/TableOfContents.tsx"
click node_changelog "https://github.com/nexu-io/harness-engineering-guide/blob/main/site/app/changelog/page.tsx"
click node_content_loader "https://github.com/nexu-io/harness-engineering-guide/blob/main/site/lib/content.ts"
click node_guide_index "https://github.com/nexu-io/harness-engineering-guide/blob/main/site/lib/guide-data.ts"
click node_navigation "https://github.com/nexu-io/harness-engineering-guide/blob/main/site/components/Navigation.tsx"
click node_shell "https://github.com/nexu-io/harness-engineering-guide/blob/main/site/app/layout.tsx"
click node_harness_topics "https://github.com/nexu-io/harness-engineering-guide/tree/main/guide"
click node_production_topics "https://github.com/nexu-io/harness-engineering-guide/tree/main/guide"
click node_evaluation_topics "https://github.com/nexu-io/harness-engineering-guide/tree/main/guide"
click node_showcases "https://github.com/nexu-io/harness-engineering-guide/tree/main/guide"
click node_zh_home "https://github.com/nexu-io/harness-engineering-guide/blob/main/site/app/zh/page.tsx"
click node_zh_guide "https://github.com/nexu-io/harness-engineering-guide/blob/main/site/app/zh/guide/%5Bslug%5D/page.tsx"
click node_zh_changelog "https://github.com/nexu-io/harness-engineering-guide/blob/main/site/app/zh/changelog/page.tsx"
click node_zh_articles "https://github.com/nexu-io/harness-engineering-guide/tree/main/zh-guide"
click node_skill "https://github.com/nexu-io/harness-engineering-guide/blob/main/skills/abuse-hunter/SKILL.md"
click node_skill_analyzer "https://github.com/nexu-io/harness-engineering-guide/blob/main/skills/abuse-hunter/scripts/analyze.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_home,node_hero,node_guide_route,node_article_layout,node_toc,node_changelog,node_content_loader,node_guide_index,node_navigation,node_shell toneBlue
class node_harness_topics,node_production_topics,node_evaluation_topics,node_showcases toneAmber
class node_zh_home,node_zh_guide,node_zh_changelog,node_zh_articles toneMint
class node_skill,node_skill_analyzer toneRose
class node_reader toneIndigo
```

## Components

### Website experience

- [Guide homepage](https://github.com/nexu-io/harness-engineering-guide/blob/main/site/app/page.tsx): `site/app/page.tsx`
- [Guide introduction](https://github.com/nexu-io/harness-engineering-guide/blob/main/site/components/Hero.tsx): `site/components/Hero.tsx`
- [Guide article route](https://github.com/nexu-io/harness-engineering-guide/blob/main/site/app/guide/%5Bslug%5D/page.tsx): `site/app/guide/[slug]/page.tsx`
- [Article layout](https://github.com/nexu-io/harness-engineering-guide/blob/main/site/components/ArticleLayout.tsx): `site/components/ArticleLayout.tsx`
- [Contents navigation](https://github.com/nexu-io/harness-engineering-guide/blob/main/site/components/TableOfContents.tsx): `site/components/TableOfContents.tsx`
- [Changelog page](https://github.com/nexu-io/harness-engineering-guide/blob/main/site/app/changelog/page.tsx): `site/app/changelog/page.tsx`
- [Markdown loader](https://github.com/nexu-io/harness-engineering-guide/blob/main/site/lib/content.ts): `site/lib/content.ts`
- [Guide navigation data](https://github.com/nexu-io/harness-engineering-guide/blob/main/site/lib/guide-data.ts): `site/lib/guide-data.ts`
- [Site navigation](https://github.com/nexu-io/harness-engineering-guide/blob/main/site/components/Navigation.tsx): `site/components/Navigation.tsx`
- [Shared site shell](https://github.com/nexu-io/harness-engineering-guide/blob/main/site/app/layout.tsx): `site/app/layout.tsx`

### Guide content

- [Harness fundamentals](https://github.com/nexu-io/harness-engineering-guide/tree/main/guide): `guide`
- [Production patterns](https://github.com/nexu-io/harness-engineering-guide/tree/main/guide): `guide`
- [Evaluation and research](https://github.com/nexu-io/harness-engineering-guide/tree/main/guide): `guide`
- [Engineering showcases](https://github.com/nexu-io/harness-engineering-guide/tree/main/guide): `guide`

### Chinese edition

- [Chinese homepage](https://github.com/nexu-io/harness-engineering-guide/blob/main/site/app/zh/page.tsx): `site/app/zh/page.tsx`
- [Chinese article route](https://github.com/nexu-io/harness-engineering-guide/blob/main/site/app/zh/guide/%5Bslug%5D/page.tsx): `site/app/zh/guide/[slug]/page.tsx`
- [Chinese changelog](https://github.com/nexu-io/harness-engineering-guide/blob/main/site/app/zh/changelog/page.tsx): `site/app/zh/changelog/page.tsx`
- [Chinese guide articles](https://github.com/nexu-io/harness-engineering-guide/tree/main/zh-guide): `zh-guide`

### Packaged skill

- [Abuse hunter skill](https://github.com/nexu-io/harness-engineering-guide/blob/main/skills/abuse-hunter/SKILL.md): `skills/abuse-hunter/SKILL.md`
- [Abuse analysis script](https://github.com/nexu-io/harness-engineering-guide/blob/main/skills/abuse-hunter/scripts/analyze.py): `skills/abuse-hunter/scripts/analyze.py`

### Other components

- **Reader**

## Connections

- Reader → Guide homepage: opens (evidence: `README.md`)
- Guide homepage → Guide introduction: renders (evidence: `site/app/page.tsx`)
- Guide homepage → Guide navigation data: uses sections (evidence: `site/app/page.tsx`)
- Reader → Guide article route: opens article (evidence: `README.md`)
- Guide article route → Markdown loader: loads article (evidence: `site/app/guide/[slug]/page.tsx`)
- Guide article route → Guide navigation data: uses ordering (evidence: `site/app/guide/[slug]/page.tsx`)
- Guide article route → Article layout: renders article (evidence: `site/app/guide/[slug]/page.tsx`)
- Article layout → Contents navigation: renders headings (evidence: `site/components/ArticleLayout.tsx`)
- Reader → Changelog page: opens updates (evidence: `README.md`)
- Changelog page → Markdown loader: loads entries (evidence: `site/app/changelog/page.tsx`)
- Shared site shell → Site navigation: renders (evidence: `site/app/layout.tsx`)
- Reader → Chinese homepage: opens Chinese edition (evidence: `README.md`)
- Chinese homepage → Guide navigation data: uses sections (evidence: `site/app/zh/page.tsx`)
- Reader → Chinese article route: opens Chinese article (evidence: `site/app/zh/guide/[slug]/page.tsx`)
- Reader → Chinese changelog: opens Chinese updates (evidence: `site/app/zh/changelog/page.tsx`)
- Chinese changelog → Markdown loader: loads entries (evidence: `site/app/zh/changelog/page.tsx`)
- Reader → Harness fundamentals: studies (evidence: `README.md`)
- Reader → Production patterns: studies (evidence: `README.md`)
- Reader → Evaluation and research: studies (evidence: `README.md`)
- Reader → Engineering showcases: reads (evidence: `README.md`)
- Reader → Chinese guide articles: reads (evidence: `README.md`)
- Reader → Abuse hunter skill: uses
- Abuse hunter skill → Abuse analysis script: runs
