Back to directory

learn-harness-engineering

Maintenance: Active

walkinglabs/learn-harness-engineering

Harness engineering beginner tutorial, from 0 to 1

View on GitHubHomepage
$ npm install

14,971

stars

1,493

forks

TypeScript

Language

MIT

License

2026-03-29

Created

2026-08-26

Last push

MIT-licensed, project-based harness engineering course (14 lectures, 8 projects, 15 languages) with copy-ready templates, the harness-creator skill and a DeepSeek harness design breakdown — an ecosystem learning resource, not a plugin installed inside dsh.

DSH integration

Ecosystem-related

Author-claimed

Safety audit

Unaudited

Last verified

2026-08-21

License

MIT

01What can it help you accomplish?

  • Learn how to build the environment that makes AI coding agents complete real engineering tasks reliably

    14 lectures and 8 hands-on projects (around one evolving Electron knowledge-base app) covering the five harness subsystems: instructions, state, verification, scope, and session lifecycle

    Engineers already using coding agents who want better stability and quality, and tech leads who need to understand how environment design affects agent performance

  • Improve an existing coding agent immediately with copy-ready harness templates

    Starter templates (AGENTS.md, init.sh, feature_list.json, session progress log) dropped into your own repository so every agent session starts from the same state

    Developers running coding agents — DeepSeek Harness (dsh), Claude Code, Codex or similar — on real projects who want more stable multi-session runs

  • Scaffold and audit a production-grade harness in your own repository

    The harness-creator skill scaffolds AGENTS.md, feature lists, init.sh and verification workflows in minutes; audit-harness.sh checks a repo against all five harness subsystems and exits 0 when all CRITICAL items pass

    Teams adopting harness engineering who want a quick scaffold and a repeatable audit for their agent workspace

02How to install into DeepSeek Harness

Prerequisites

  • Familiarity with the terminal, git, and local development environments (course prerequisite)
  • Node.js / npm to run the VitePress documentation site locally
  • At least one coding agent (Claude Code, Codex, or another IDE/CLI agent supporting file editing, command execution, and multi-step tasks) to complete the projects

Installation steps

  1. 01

    Clone the repository, or read the course on the documentation website (walkinglabs.github.io/learn-harness-engineering)

  2. 02

    Run `npm install` to install the VitePress tooling

    $ npm install

  3. 03

    Run `npm run docs:dev` and open the local URL that VitePress outputs in your browser

    $ npm run docs:dev

Verify the integration

Not specified by the author

03DSH integration and capability boundaries

DSH integrationEcosystem-related

Ecosystem learning resource: a course teaching harness engineering methodology (including a breakdown of DeepSeek's harness design) — read it online or locally, then apply its templates and methods to your own coding-agent workflows; it is not installed inside dsh.

  • Project-based harness engineering course

    14 lectures + 8 hands-on projects + learning path in the repo's docsa systematic method for the five harness subsystems (instructions, state, verification, scope, lifecycle) applied to real repositories

  • Copy-ready Resource Library

    templates such as AGENTS.md, feature_list.json and init.shdrop-in harness files you can use in your own repositories today

    you copy template files into your own repository
  • harness-creator skill + audit-harness.sh

    your own project repositorya scaffolded production-grade harness (AGENTS.md, feature lists, init.sh, verification workflows); an audit that exits 0 when all CRITICAL items pass

    harness-creator scaffolds harness files into your projectthe one-liner `curl ... | bash` downloads and executes a remote shell script; you can clone the repo and run `bash tools/audit-harness.sh` locally instead
  • 15-language content and PDF coursebooks

    course sources translated into 15 languageslocalized course pages; PDF coursebooks generated via `npm run pdf:build`

    `npm run pdf:build` writes output files to artifacts/pdfs/

04Who is it for? When not to use it?

Good for

  • Engineers already using coding agents who want better stability and quality, and tech leads who need to understand how environment design affects agent performance
  • Developers running coding agents — DeepSeek Harness (dsh), Claude Code, Codex or similar — on real projects who want more stable multi-session runs
  • Teams adopting harness engineering who want a quick scaffold and a repeatable audit for their agent workspace

Not for

  • The hands-on projects require at least one coding agent (Claude Code, Codex, or another IDE/CLI agent with file editing, command execution and multi-step tasks). Without one you can read the course but cannot complete the projects as intended.
  • The README's quick way to run audit-harness.sh pipes a remote script into bash (curl ... | bash), which executes network-fetched code on your machine. If you prefer not to, clone the repo and run `bash tools/audit-harness.sh /path/to/your/repo` locally instead.

05Compatibility, maintenance and safety notes

  • The hands-on projects require at least one coding agent (Claude Code, Codex, or another IDE/CLI agent with file editing, command execution and multi-step tasks). Without one you can read the course but cannot complete the projects as intended.
  • The README's quick way to run audit-harness.sh pipes a remote script into bash (curl ... | bash), which executes network-fetched code on your machine. If you prefer not to, clone the repo and run `bash tools/audit-harness.sh /path/to/your/repo` locally instead.
  • The course is actively evolving content — new lectures and projects were added in July and August 2026 — and has no tagged release, so course structure and materials may change between checkouts.
2026-03-292026-08-19Not specified by the author

MIT · actively maintained (last push 2026-08-19)

06Frequently asked questions

Is this a plugin I install inside DeepSeek Harness?

No. It is an ecosystem learning resource — a course repository. You read it online or locally via VitePress (`npm install`, then `npm run docs:dev`), then apply its methods and copy its templates (AGENTS.md, init.sh, feature_list.json) into your own repo. The course is agent-agnostic and includes a breakdown of how DeepSeek builds its harness ("everything is a plugin," capability seams, event pipeline).

What do I need before starting the projects?

Familiarity with the terminal, git and local development environments, plus at least one coding agent — Claude Code, Codex, or another IDE/CLI agent that supports file editing, command execution and multi-step tasks. Without such a tool you can still read the course, but you won't be able to complete the projects as intended.

How do the harness templates work with my own coding agent?

Grab the starter templates from the Resource Library and drop them into your project root: AGENTS.md as the agent's operating manual, init.sh, feature_list.json, and a session progress log. The README notes the progress file is agent-agnostic: Codex, OpenHands, Antigravity and other coding agents can use the same file when their root instructions tell them to read it at startup and update it before handoff.

What are the harness-creator skill and audit-harness.sh?

harness-creator is a reusable agent skill that scaffolds a production-grade harness (AGENTS.md, feature lists, init.sh, verification workflows) for your own project in minutes. audit-harness.sh is a zero-dependency shell script that checks an existing repo against all five harness subsystems (L03–L12) and exits 0 when all CRITICAL items pass — no Node.js required.

Is the course available in Chinese or Japanese?

Yes. The course is available in 15 languages — including Simplified Chinese, Traditional Chinese and Japanese — with full translation coverage, and you can also build PDF coursebooks locally with `npm run pdf:build`.

08Data and sources

  • Author-claimedgithub.com12fc49c9cc16…

    Learn Harness Engineering is a course dedicated to the engineering of AI coding agents.

  • Author-claimedgithub.com12fc49c9cc16…

    [How DeepSeek builds its harness](docs/en/harness-designs/deepseek/index.md) — "everything is a plugin," capability seam…

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-21. Found an error? Submit a correction.

🏆

Best DeepSeek Harness Plugins

Twelve plugins worth installing first — picked from the whole catalog, across every category.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.