Home / harness-engineering-101
harness-engineering-101
WatchingWatchingNone of the above. Nothing stands out yet. More on the methodology pageIsuruMaduranga/harness-engineering-101
Harness Engineering 101 — building AI agents from first principles. The LLM is the brain; the harness is the body.
PythonCategories: Coding agents
Our summary
A 16-chapter book series titled Harness Engineering 101, which explains how to build AI agents from first principles. It grows a toy agent of about 300 lines of plain Python across its chapters.
Who it is for: Developers who want to understand how AI agents work internally
What the README claims
- An LLM API is stateless and receives the full conversation as a JSON array each turn
Every turn, you send the entire conversation as a JSON array and get text back.
Not checked - The series develops its ideas across 16 chapters
This series develops that one idea across 16 chapters, growing a ~300-line toy agent in plain Python as it goes.
Not checked - The book includes a runnable toy harness with one file per stage
The runnable toy harness, one file per stage
Not checked - The author uses the same ideas in an open-source coding agent called One Code
I use the same ideas in [One Code](https://github.com/IsuruMaduranga/one-code), an open-source coding agent built on [pi]
Not checked - The prose is licensed under CC BY-NC-ND 4.0 and the code under MIT
is licensed under [Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International
Not checked
Written by AI from the project's README on 2026-10-20. It does not affect the verdict.
Watching: no other rule matched yet.
7-day star gain 5, down from 10 the week before.
Gaining 5 stars this week. Last push 20 days ago.
Verdict
MID scored 1h ago
- Hype
- 29
- Reality
- 19
- Hype Gap
- +10
- Momentum
- -
- Confidence
- 60%
- Maintained moves Reality -20 points.
- Responsive moves Reality -4 points.
Rule verdict-2.0, scoring score-2.0. How we score. Backtest.
Maintained by
Maintained by 1 primary developer, 0 external contributors in the last 90 days.
- IsuruMaduranga is a GitHub individual account.
- GitHub account created February 2018.
- Top contributors by commits: IsuruMaduranga 100%.
Why now 1% of its stars arrived in the last 7 days. No Hacker News posts in the last 7 days.
- Stars StarsThe number of GitHub stars on the repository at our latest reading.
- 660
- Gain 7d Gain 7dStars gained since our latest reading from at least 7 days ago.
- +5
- Pace Velocity (Nx usual pace)This week's star gain divided by the project's usual weekly gain. The usual gain is the average weekly gain over the 4 weeks before (days 8 to 35 ago), counted as at least 10 stars. 2.0x means twice the usual pace. Without a reading from 35 days ago, the ranking assumes 2% of the stars the project had 7 days ago as its usual weekly gain. More on the methodology page
- 0.4x
- HN points HN pointsHacker News points added up across posts that mention the project, published in the last 7 days.
- 0 7 days
- Downloads DownloadsDownloads per day of the project's package, as the registry (npm or PyPI) reports them.
- n/a
- Contributors Contributors, all timePeople and anonymous contributors who have ever committed to the repository, as GitHub counts them. A small number is context, not a flaw: many solid projects are kept by one or two people.
- 1
- Last release Latest releaseDays since the latest GitHub release was published.
- n/a
Gain 24h Gain 24hStars gained since our latest reading from at least 24 hours ago. 0. Forks ForksThe number of GitHub forks of the repository at our latest reading. 69. Open issues Open issuesThe number of open issues on the repository at our latest reading, as GitHub counts them. 2. Days since push Days since pushDays since the last push to the repository. 20 days. Archived ArchivedWhether the owner has archived the repository on GitHub. An archived repository is read-only. no. Hacker News posts in 7 days Hacker News postsThe number of Hacker News posts that mention the project, published in the last 7 days.: 0. Watchers WatchersThe number of GitHub users watching the repository for notifications, at our latest reading. 1.
Facts
Nerd stuff
- Languages
- Python (detected), JavaScript (detected), Shell (detected)
- Docs
- docs/ folder (detected)
The Receipts
| Source | Evidence | Date |
|---|---|---|
| Hacker News | Thread, 132 points, 64 comments | 19 Oct 2026 |
What changed recently
GitHub release dates we stored. We do not track license changes yet.
Cite this
harness-engineering-101 is a GitHub project at https://github.com/IsuruMaduranga/harness-engineering-101 written mainly in Python, described there as "Harness Engineering 101 - building AI agents from first principles. The LLM is the brain; the harness is the body".
Source: https://midorreal.com/project/isurumaduranga-harness-engineering-101, checked 22 November 2026. The same facts as JSON: /project/isurumaduranga-harness-engineering-101.json.
Rank history
Peak day: +139 stars on 20 Oct 2026, 33 days ago.
Best rank on Blowing up: #52 on 27 Oct 2026.
Stars
Packages
- We checked npm, PyPI, Docker Hub, crates.io and Homebrew and found no package that links to this repository.
Signals
| Source | What we measured | Checked |
|---|---|---|
| GitHub | 660 stars, 5 gained in 7 days | 22 Nov 2026 |
| Hacker News | 1 post stored, 0 points in the last 7 days | 26 Oct 2026 |
| Feed mentions | Not tracked yet | - |
| npm | No linked package found | - |
| PyPI | No linked package found | - |
| Docker Hub | No linked package found | - |
| crates.io | No linked package found | - |
| Homebrew | No linked package found | - |
| deps.dev | Not tracked yet | - |
| Hugging Face | Not tracked yet | - |
| Bluesky | Not tracked yet | - |
| Stack Exchange | Not tracked yet | - |
| YouTube | Not tracked yet | - |
Attention vs adoption
Attention: above 44% of tracked projects
Star velocity against all tracked projects
Adoption: not enough data to rank
Downloads, dependents and pulls
Not enough comparable data yet to set attention against adoption. This describes the numbers; it is not a verdict.
Compared with Coding agents
| Measure | This project | Category median |
|---|---|---|
| Star velocity | 0.4 | 0.4 |
| Days since release | no data | 4.5 |
| Contributors, all time | 1 | 2 |
| Median time to first reply on issues | 8 days | 14 hours |
| Commits in the last 30 days | 1 | 48 |
Star velocity: above 49% of Coding agents projects
Contributors, all time: above 0% of Coding agents projects
Median time to first reply on issues: above 88% of Coding agents projects
Commits in the last 30 days: above 9% of Coding agents projects
Compared with the project's first category only. A percentile line appears only where at least 30 projects in the category have the measure. This describes the numbers; it is not a verdict.
Compare with
Hacker News
| Post | Points PointsThe points the post has on Hacker News. | Comments CommentsThe number of comments on the post on Hacker News. | Date |
|---|---|---|---|
| Hacker News post | 132 | 64 | 19 Oct 2026 |
Caveats
Repo health
- Languages LanguagesShare of the repository's code by bytes, as GitHub's language detection reports it. The five biggest languages are named and the rest are grouped as Other.Python 91%, JavaScript 6%, Shell 3%
- License LicenseThe SPDX license id GitHub detects, and a class: Open source (OSI) if the license is on the Open Source Initiative approved list, Source-available if the code is readable but the license limits use, Unclear if GitHub cannot match a known license, No license detected if it finds none. A public repository without a license is not open source.Unclear
- Repository age Repository ageTime since the repository was created on GitHub. This is the repository, not necessarily the project, which may have existed elsewhere before.2 months, created 6 Sep 2026
Development
- Commits in the last 7 days Commits in the last 7 daysCommits to the repository in the last 7 days, as GitHub counts them.0
- Commits in the last 30 days Commits in the last 30 daysCommits to the repository in the last 30 days, as GitHub counts them.1
- Commits in the last 90 days Commits in the last 90 daysCommits to the repository in the last 90 days, as GitHub counts them.30
- Contributors, all time Contributors, all timePeople and anonymous contributors who have ever committed to the repository, as GitHub counts them. A small number is context, not a flaw: many solid projects are kept by one or two people.1, a small team
- Releases ReleasesThe number of GitHub releases, and how many days ago the latest one was published.0
- Issues in the last 30 days Issues in the last 30 daysIssues opened and issues closed in the last 30 days, as GitHub search counts them.3 opened, 2 closed
- Pull requests merged in the last 30 days Pull requests merged in the last 30 daysPull requests merged in the last 30 days, as GitHub search counts them.0
Maintenance
- Median time to first reply on issues Median time to first reply on issuesMedian time between an issue being opened and the first comment from someone other than its author, over a sample of the last 30 closed issues. Issues with no reply are left out of the median and counted separately.8 days
- Median time to close issues Median time to close issuesMedian time from opening to closing, over a sample of the last 30 closed issues.8 days
- Sampled issues with no reply Sampled issues with no replyHow many of the sampled closed issues never got a comment from someone other than their author.0 of 2
- Stale open issues Stale open issuesOpen issues with no update in the last 90 days, as GitHub search counts them.0
- Open pull requests Open pull requestsPull requests open now, as GitHub search counts them.0
Hygiene
- Automated tests or builds (CI) Automated tests or builds (CI)Whether the repository has at least one GitHub Actions workflow file in .github/workflows.No
- A tests folder A tests folderWhether the repository has a top-level folder named tests, test, __tests__ or spec.No
- A license A licenseWhether GitHub detects a license file in the repository.Yes
- Contributing guide Contributing guideWhether the repository has a contributing guide.No
- Code of conduct Code of conductWhether GitHub finds a code of conduct in the repository.No
- CODEOWNERS file CODEOWNERS fileWhether the repository has a CODEOWNERS file, which names who reviews changes to which files.No
- A Dockerfile A DockerfileWhether the repository has a Dockerfile at its top level.No
Security
- Security policy Security policyWhether the repository has a SECURITY.md or SECURITY.rst file.No
- Unpatched high or critical advisories Unpatched high or critical advisoriesPublished GitHub security advisories rated high or critical on this repository that list a vulnerable version with no patched version.0
Badge
For maintainers: one measured fact, no verdict.
Markdown
[](https://midorreal.com/project/isurumaduranga-harness-engineering-101)
HTML
<a href="https://midorreal.com/project/isurumaduranga-harness-engineering-101"><img src="https://midorreal.com/badge/isurumaduranga-harness-engineering-101.svg" alt="Mid or Real"></a>
Verdict badge: It shows the verdict as this page shows it today.
Markdown
[](https://midorreal.com/project/isurumaduranga-harness-engineering-101)
HTML
<a href="https://midorreal.com/project/isurumaduranga-harness-engineering-101"><img src="https://midorreal.com/badge/isurumaduranga-harness-engineering-101.svg?style=verdict" alt="Mid or Real: MID"></a>
Passport
Copy these facts into a post, a README or a page. Cite as "Source: Mid or Real". Full record: JSON.
First tracked 19 Oct 2026 at 65 stars.
- GitHub data 4 h old
- Hacker News data 26 d old
Is this your project? Claim it
Figures by method 1.0