Vibeleaderboard
Index / tool
Visit learn.shareai.run
Category
Education
Rank
Pricing
Open Source
Type
TOOL
Date

About

A 17-lesson course on harness engineering — the tooling, permissions, context management and task plumbing that surround a model rather than the model itself. Each lesson isolates one mechanism (agent loop, tool dispatch, permission boundaries, task persistence, background execution, agent teams, workflow orchestration, goal evaluation) and ships a standalone Python implementation plus a README in English, Chinese and Japanese. Its argument is that agency comes from model training, so the surrounding code's job is to build the world the model acts in.

What it does

A progressive, runnable course that starts with a basic model and tool loop, then adds planning, isolated workers, persistent task graphs, team messaging, permissions, memory, and external capability routing. Each lesson explains one mechanism with diagrams, code, and prompts to try.

Why it's ranked here

The project earns attention because it exposes concrete mechanics instead of stopping at agent terminology. Its strongest material shows how context isolation, dependency tracking, and asynchronous communication fit around a stable core loop. The opinionated framing is useful, though broader than the supplied implementations prove.

What's good

Lessons isolate one change at a time and explain the problem before showing the mechanism. Path checks demonstrate workspace containment. Subagents discard noisy histories and return summaries. Disk-backed dependency graphs survive context compression. Team examples make lifecycle states and mailbox communication tangible rather than abstract.

Tradeoffs

Two tutorial tracks coexist, and their chapter numbers do not always align. Readers must stay within one track. Several examples use deliberately simple controls: fixed iteration limits, threaded workers, file-based coordination, and mailboxes that empty when read. These choices teach clearly but leave reliability questions beyond the demonstrated scope.

How to use it well

Use it as a hands-on architecture course for developers building model-driven coding tools or similar operational environments. Follow the current lessons in order, run each example, and compare every added mechanism with the unchanged loop. It does not cover training models, and it should not substitute for production hardening guidance.

Technical notes+

README.md identifies root-level s01-s17 as the canonical track and docs/ plus agents/ as the legacy 12-lesson track. requirements.txt declares anthropic>=0.25.0, python-dotenv>=1.0.0, and pyyaml>=6.0. docs/en/s02-tool-use.md implements handler dispatch and resolved-path workspace checks. docs/en/s04-subagent.md gives child agents independent message histories and returns only final text. docs/en/s07-task-system.md persists one JSON file per task and clears dependency edges when tasks complete. docs/en/s09-agent-teams.md runs teammate loops in daemon threads, stores roster state in JSON, and uses drain-on-read JSONL inboxes.

Observed

Primary language
Python
Install surface
Python dependencies are declared in requirements.txt for installation with standard Python package tooling.
Model interface
Uses the Anthropic Python SDK, with a declared minimum dependency of 0.25.0.
User interface
Runnable command-line lesson programs accept prompts and expose commands for team and inbox inspection.
Documentation languages
English, Chinese, and Japanese documentation are provided.
Repository structure
A canonical 17-lesson track coexists with a preserved legacy 12-lesson track.

Read from README.md, requirements.txt, docs/en/s02-tool-use.md, docs/en/s04-subagent.md, docs/ja/s02-tool-use.md, docs/ja/s04-subagent.md, docs/zh/s02-tool-use.md, docs/zh/s04-subagent.md, docs/en/s03-todo-write.md, docs/ja/s03-todo-write.md, docs/zh/s03-todo-write.md, docs/en/s07-task-system.md, docs/en/s09-agent-teams.md, docs/ja/s07-task-system.md, docs/ja/s09-agent-teams.md.

Tags

claude-codeagent-harnesstutorialpythonai-agentscourse

Tech Stack

Python

Comments (0)

No comments yet

Editorially curated, with community endorsements as a secondary signal. Corrections welcome.