# deusyu/harness-engineering architecture

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

- Interactive diagram: https://gitdiagram.com/deusyu/harness-engineering
- Repository: https://github.com/deusyu/harness-engineering

## Overview

This repository is a Harness Engineering learning guide and research archive, not a runtime software product. Its principal learning journey moves from research and concept notes through independent analysis, a small hands-on experiment, feedback, and publishable work. It also maintains related tools and prompts as reusable learning resources. The README documents these stages and their intended sequence; implementation-level links among unsampled content are not inferred.

Main entry points: [`README.md`](https://github.com/deusyu/harness-engineering/blob/main/README.md) (Learning guide), [`practice/01-ralph-demo/README.md`](https://github.com/deusyu/harness-engineering/blob/main/practice/01-ralph-demo/README.md) (Ralph demo), [`tools`](https://github.com/deusyu/harness-engineering/tree/main/tools) (Harness tools), [`references/articles.md`](https://github.com/deusyu/harness-engineering/blob/main/references/articles.md) (Article summaries)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_research["Research library"]
  node_references["Article summaries<br/>[articles.md]"]
end

subgraph group_learning["Learning stages"]
  node_concepts["Core concepts"]
  node_thinking["Independent analysis"]
  node_feedback["Practice feedback"]
end

subgraph group_practice["Practice resources"]
  node_demo["Ralph demo<br/>[README.md]"]
  node_demo_prompt["Demo prompt<br/>[PROMPT.md]"]
  node_demo_config["Ralph configuration<br/>[ralph.yml]"]
  node_word_counter["Word counter<br/>[wc.py]"]
  node_tools["Harness tools"]
  node_prompts["Prompt collection"]
  node_overview["Tool overview<br/>[00-overview.md]"]
  node_ralph_orchestrator["Ralph orchestrator"]
end

subgraph group_outputs["Published work"]
  node_works["Translations and essays"]
end

node_learner(("Learner"))
node_guide["Learning guide<br/>[README.md]"]

node_learner -->|"studies"| node_guide
node_guide -->|"explores research"| node_references
node_guide -->|"learns concepts"| node_concepts
node_guide -->|"forms views"| node_thinking
node_guide -->|"tries practice"| node_demo
node_guide -->|"records feedback"| node_feedback
node_guide -->|"produces work"| node_works
node_demo -->|"uses prompt"| node_demo_prompt
node_demo -->|"uses configuration"| node_demo_config
node_demo -->|"demonstrates"| node_word_counter
node_guide -->|"consults tools"| node_tools
node_guide -->|"consults prompts"| node_prompts
node_tools -->|"introduces"| node_overview
node_tools -->|"documents harness"| node_ralph_orchestrator

click node_guide "https://github.com/deusyu/harness-engineering/blob/main/README.md"
click node_references "https://github.com/deusyu/harness-engineering/blob/main/references/articles.md"
click node_concepts "https://github.com/deusyu/harness-engineering/tree/main/concepts"
click node_thinking "https://github.com/deusyu/harness-engineering/tree/main/thinking"
click node_demo "https://github.com/deusyu/harness-engineering/blob/main/practice/01-ralph-demo/README.md"
click node_demo_prompt "https://github.com/deusyu/harness-engineering/blob/main/practice/01-ralph-demo/PROMPT.md"
click node_demo_config "https://github.com/deusyu/harness-engineering/blob/main/practice/01-ralph-demo/ralph.yml"
click node_word_counter "https://github.com/deusyu/harness-engineering/blob/main/practice/01-ralph-demo/wc.py"
click node_feedback "https://github.com/deusyu/harness-engineering/tree/main/feedback"
click node_works "https://github.com/deusyu/harness-engineering/tree/main/works"
click node_tools "https://github.com/deusyu/harness-engineering/tree/main/tools"
click node_prompts "https://github.com/deusyu/harness-engineering/tree/main/prompts"
click node_overview "https://github.com/deusyu/harness-engineering/blob/main/tools/00-overview.md"
click node_ralph_orchestrator "https://github.com/deusyu/harness-engineering/blob/main/tools/harnesses/ralph-orchestrator.md"

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_references toneBlue
class node_concepts,node_thinking,node_feedback toneAmber
class node_demo,node_demo_prompt,node_demo_config,node_word_counter,node_tools,node_prompts,node_overview,node_ralph_orchestrator toneMint
class node_works toneRose
class node_learner toneIndigo
class node_guide toneTeal
```

## Components

### Research library

- [Article summaries](https://github.com/deusyu/harness-engineering/blob/main/references/articles.md): `references/articles.md`

### Learning stages

- [Core concepts](https://github.com/deusyu/harness-engineering/tree/main/concepts): `concepts`
- [Independent analysis](https://github.com/deusyu/harness-engineering/tree/main/thinking): `thinking`
- [Practice feedback](https://github.com/deusyu/harness-engineering/tree/main/feedback): `feedback`

### Practice resources

- [Ralph demo](https://github.com/deusyu/harness-engineering/blob/main/practice/01-ralph-demo/README.md): `practice/01-ralph-demo/README.md`
- [Demo prompt](https://github.com/deusyu/harness-engineering/blob/main/practice/01-ralph-demo/PROMPT.md): `practice/01-ralph-demo/PROMPT.md`
- [Ralph configuration](https://github.com/deusyu/harness-engineering/blob/main/practice/01-ralph-demo/ralph.yml): `practice/01-ralph-demo/ralph.yml`
- [Word counter](https://github.com/deusyu/harness-engineering/blob/main/practice/01-ralph-demo/wc.py): `practice/01-ralph-demo/wc.py`
- [Harness tools](https://github.com/deusyu/harness-engineering/tree/main/tools): `tools`
- [Prompt collection](https://github.com/deusyu/harness-engineering/tree/main/prompts): `prompts`
- [Tool overview](https://github.com/deusyu/harness-engineering/blob/main/tools/00-overview.md): `tools/00-overview.md`
- [Ralph orchestrator](https://github.com/deusyu/harness-engineering/blob/main/tools/harnesses/ralph-orchestrator.md): `tools/harnesses/ralph-orchestrator.md`

### Published work

- [Translations and essays](https://github.com/deusyu/harness-engineering/tree/main/works): `works`

### Other components

- **Learner**
- [Learning guide](https://github.com/deusyu/harness-engineering/blob/main/README.md): `README.md`

## Connections

- Learner → Learning guide: studies (evidence: `README.md`)
- Learning guide → Article summaries: explores research (evidence: `README.md`)
- Learning guide → Core concepts: learns concepts (evidence: `README.md`)
- Learning guide → Independent analysis: forms views (evidence: `README.md`)
- Learning guide → Ralph demo: tries practice (evidence: `README.md`)
- Learning guide → Practice feedback: records feedback (evidence: `README.md`)
- Learning guide → Translations and essays: produces work (evidence: `README.md`)
- Ralph demo → Demo prompt: uses prompt (evidence: `README.md`)
- Ralph demo → Ralph configuration: uses configuration (evidence: `README.md`)
- Ralph demo → Word counter: demonstrates (evidence: `README.md`)
- Learning guide → Harness tools: consults tools (evidence: `README.md`)
- Learning guide → Prompt collection: consults prompts (evidence: `README.md`)
- Harness tools → Tool overview: introduces (evidence: `README.md`)
- Harness tools → Ralph orchestrator: documents harness (evidence: `README.md`)
