# singhsidhukuldeep/harness-engineering architecture

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

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

## Overview

Harness Engineering is an offline, bilingual course that teaches engineers to build systems around coding agents. Learners study a concept through a runnable lecture demo, practice it in a starter exercise, then apply cumulative mechanisms in projects. The README describes deterministic stand-ins in place of model calls and Python and TypeScript tracks sharing one specification. The tree confirms these curriculum paths; sampled project code shows examples including knowledge-base continuity and self-verification. Unsampled lesson and project internals are represented only at their enclosing paths.

Main entry points: [`projects`](https://github.com/singhsidhukuldeep/harness-engineering/tree/main/projects) (Projects 01–05), [`lectures`](https://github.com/singhsidhukuldeep/harness-engineering/tree/main/lectures) (Lectures 01–13), [`lectures/lecture-01-why-capable-agents-still-fail/exercises`](https://github.com/singhsidhukuldeep/harness-engineering/tree/main/lectures/lecture-01-why-capable-agents-still-fail/exercises) (Exercises), [`lectures/lecture-01-why-capable-agents-still-fail/code/python/main.py`](https://github.com/singhsidhukuldeep/harness-engineering/blob/main/lectures/lecture-01-why-capable-agents-still-fail/code/python/main.py) (Python Track)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_curriculum["Lecture Curriculum"]
  node_lectures["Lectures 01–13"]
  node_lecture_demos["Runnable Demos<br/>[main.py]"]
end

subgraph group_practice["Exercises"]
  node_exercises["Exercises"]
  node_exercise_starters["Exercise Starters<br/>[main.py]"]
  node_exercise_solutions["Exercise Solutions<br/>[main.py]"]
end

subgraph group_projects["Applied Projects"]
  node_projects["Projects 01–05"]
  node_baseline_project["Harness Comparison<br/>[main.ts]"]
  node_continuity_project["Session Continuity<br/>[main.py]"]
  node_feedback_project["Feedback and Scope<br/>[main.py]"]
  node_verification_project["Self Verification<br/>[main.py]"]
end

subgraph group_tracks["Language Tracks"]
  node_python_track["Python Track<br/>[main.py]"]
  node_typescript_track["TypeScript Track<br/>[main.ts]"]
end

node_engineer(("Engineer"))
node_standin["Deterministic Stand-in"]

node_engineer -->|"studies"| node_lectures
node_lectures -->|"includes demos"| node_lecture_demos
node_engineer -->|"practices in"| node_exercises
node_exercises -->|"provides starters"| node_exercise_starters
node_exercises -->|"provides solutions"| node_exercise_solutions
node_engineer -->|"applies concepts"| node_projects
node_projects -->|"includes"| node_baseline_project
node_projects -->|"includes"| node_continuity_project
node_projects -->|"includes"| node_feedback_project
node_projects -->|"includes"| node_verification_project
node_python_track -->|"uses for demos"| node_standin
node_typescript_track -->|"uses for demos"| node_standin
node_lectures -->|"offers track"| node_python_track
node_lectures -->|"offers track"| node_typescript_track

click node_lectures "https://github.com/singhsidhukuldeep/harness-engineering/tree/main/lectures"
click node_lecture_demos "https://github.com/singhsidhukuldeep/harness-engineering/blob/main/lectures/lecture-01-why-capable-agents-still-fail/code/python/main.py"
click node_exercises "https://github.com/singhsidhukuldeep/harness-engineering/tree/main/lectures/lecture-01-why-capable-agents-still-fail/exercises"
click node_exercise_starters "https://github.com/singhsidhukuldeep/harness-engineering/blob/main/lectures/lecture-01-why-capable-agents-still-fail/exercises/exercise-01-failure-triage/starter/python/main.py"
click node_exercise_solutions "https://github.com/singhsidhukuldeep/harness-engineering/blob/main/lectures/lecture-01-why-capable-agents-still-fail/exercises/exercise-01-failure-triage/solution/python/main.py"
click node_projects "https://github.com/singhsidhukuldeep/harness-engineering/tree/main/projects"
click node_baseline_project "https://github.com/singhsidhukuldeep/harness-engineering/blob/main/projects/project-01-baseline-vs-minimal-harness/solution/typescript/main.ts"
click node_continuity_project "https://github.com/singhsidhukuldeep/harness-engineering/blob/main/projects/project-03-multi-session-continuity/solution/python/main.py"
click node_feedback_project "https://github.com/singhsidhukuldeep/harness-engineering/blob/main/projects/project-04-runtime-feedback-and-scope-control/solution/python/main.py"
click node_verification_project "https://github.com/singhsidhukuldeep/harness-engineering/blob/main/projects/project-05-self-verification-and-role-separation/solution/python/main.py"
click node_python_track "https://github.com/singhsidhukuldeep/harness-engineering/blob/main/lectures/lecture-01-why-capable-agents-still-fail/code/python/main.py"
click node_typescript_track "https://github.com/singhsidhukuldeep/harness-engineering/blob/main/lectures/lecture-01-why-capable-agents-still-fail/code/typescript/main.ts"

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_lectures,node_lecture_demos toneBlue
class node_exercises,node_exercise_starters,node_exercise_solutions toneAmber
class node_projects,node_baseline_project,node_continuity_project,node_feedback_project,node_verification_project toneMint
class node_python_track,node_typescript_track toneRose
class node_engineer,node_standin toneIndigo
```

## Components

### Lecture Curriculum

- [Lectures 01–13](https://github.com/singhsidhukuldeep/harness-engineering/tree/main/lectures): `lectures`
- [Runnable Demos](https://github.com/singhsidhukuldeep/harness-engineering/blob/main/lectures/lecture-01-why-capable-agents-still-fail/code/python/main.py): `lectures/lecture-01-why-capable-agents-still-fail/code/python/main.py`

### Exercises

- [Exercises](https://github.com/singhsidhukuldeep/harness-engineering/tree/main/lectures/lecture-01-why-capable-agents-still-fail/exercises): `lectures/lecture-01-why-capable-agents-still-fail/exercises`
- [Exercise Starters](https://github.com/singhsidhukuldeep/harness-engineering/blob/main/lectures/lecture-01-why-capable-agents-still-fail/exercises/exercise-01-failure-triage/starter/python/main.py): `lectures/lecture-01-why-capable-agents-still-fail/exercises/exercise-01-failure-triage/starter/python/main.py`
- [Exercise Solutions](https://github.com/singhsidhukuldeep/harness-engineering/blob/main/lectures/lecture-01-why-capable-agents-still-fail/exercises/exercise-01-failure-triage/solution/python/main.py): `lectures/lecture-01-why-capable-agents-still-fail/exercises/exercise-01-failure-triage/solution/python/main.py`

### Applied Projects

- [Projects 01–05](https://github.com/singhsidhukuldeep/harness-engineering/tree/main/projects): `projects`
- [Harness Comparison](https://github.com/singhsidhukuldeep/harness-engineering/blob/main/projects/project-01-baseline-vs-minimal-harness/solution/typescript/main.ts): `projects/project-01-baseline-vs-minimal-harness/solution/typescript/main.ts`
- [Session Continuity](https://github.com/singhsidhukuldeep/harness-engineering/blob/main/projects/project-03-multi-session-continuity/solution/python/main.py): `projects/project-03-multi-session-continuity/solution/python/main.py`
- [Feedback and Scope](https://github.com/singhsidhukuldeep/harness-engineering/blob/main/projects/project-04-runtime-feedback-and-scope-control/solution/python/main.py): `projects/project-04-runtime-feedback-and-scope-control/solution/python/main.py`
- [Self Verification](https://github.com/singhsidhukuldeep/harness-engineering/blob/main/projects/project-05-self-verification-and-role-separation/solution/python/main.py): `projects/project-05-self-verification-and-role-separation/solution/python/main.py`

### Language Tracks

- [Python Track](https://github.com/singhsidhukuldeep/harness-engineering/blob/main/lectures/lecture-01-why-capable-agents-still-fail/code/python/main.py): `lectures/lecture-01-why-capable-agents-still-fail/code/python/main.py`
- [TypeScript Track](https://github.com/singhsidhukuldeep/harness-engineering/blob/main/lectures/lecture-01-why-capable-agents-still-fail/code/typescript/main.ts): `lectures/lecture-01-why-capable-agents-still-fail/code/typescript/main.ts`

### Other components

- **Engineer**
- **Deterministic Stand-in**

## Connections

- Engineer → Lectures 01–13: studies
- Lectures 01–13 → Runnable Demos: includes demos
- Engineer → Exercises: practices in
- Exercises → Exercise Starters: provides starters
- Exercises → Exercise Solutions: provides solutions
- Engineer → Projects 01–05: applies concepts
- Projects 01–05 → Harness Comparison: includes
- Projects 01–05 → Session Continuity: includes
- Projects 01–05 → Feedback and Scope: includes
- Projects 01–05 → Self Verification: includes
- Python Track → Deterministic Stand-in: uses for demos
- TypeScript Track → Deterministic Stand-in: uses for demos
- Lectures 01–13 → Python Track: offers track
- Lectures 01–13 → TypeScript Track: offers track