abpai/Harness Doctor

Scan a repository for good agent-harness practices with deterministic checks

View on GitHub

Trust Signals

Scorecard Score
not yet scored
Maintenance Recency
Activelast commit Jul 10, 2026
License
MIT

Pinned Snippet

workflow.ymlSHA-pinned
uses: abpai/harness-doctor@83e233831e6b56cd6583f3d9d018c6cf8fdf8775 # @andypai/harness-doctor@0.3.0

tags can be moved; commit SHAs can't. why a SHA?

namedescriptionrequireddefault
directoryProject directory to scan.
projectWorkspace project(s) to scan (comma-separated)no
fail-onExit non-zero when diagnostics fire (error, warning, none).error
non-blockingAdvisory mode. Report findings but always exit 0 so neither the fail-on gate nor a scan error fails the workflow.false
commentCreate or update a sticky pull request summary comment.true
annotationsEmit diagnostics as GitHub Actions annotations.true
bun-versionBun version to use1.3.14
versionharness-doctor npm version or package spec to runlatest
namedescription
scoreHealth score (0-100). Empty when scoring was unavailable.
total-issuesTotal diagnostic count in the scan report.
error-countError diagnostic count in the scan report.
warning-countWarning diagnostic count in the scan report.
affected-filesNumber of files with diagnostics.