seanrobertwright

Harness Score — AI skill for Claude Code

AI community

Archon workflow that scores a repo's AI-agent readiness across 10 MVP checks (0-100).

How to install Harness Score

This entry records only its repository, not the path inside it, so there is no exact command to give. Open seanrobertwright/harness-score and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Harness Score does

Archon workflow that scores a repo's AI-agent readiness across 10 MVP checks (0-100). Deterministic detection + Claude Opus 4.7 synthesis.

Alternatives in AI

README

harness-score

An [Archon](https://github.com/coleam00/Archon) workflow that audits a repository and answers:

**How ready is this repo for reliable AI-agent-driven development?**

Produces a Harness Score out of 100 with a rating, per-check breakdown, and ranked fixes.

Based on the [Archon Harness Score Diagnostic System](https://github.com/coleam00/Archon/discussions) MVP spec.


What it does

Two nodes, ~25 seconds end-to-end:

  1. detect (deterministic Bun script) — scans the repo for 10 MVP signals and emits scored JSON to stdout.
  2. report (Claude Opus 4.7) — reads the JSON and writes $ARTIFACTS_DIR/harness-score.md with rating, score table, and the top 3 fixes ranked by potential score gain.

Checks

# Check Max What it looks for
1 agent_instructions 10 AGENTS.md, CLAUDE.md, .cursorrules, or AGENT.md at repo root
2 readme 10 README.md, README.rst, README.txt, or README
3 build_test_commands 10 package.json / pyproject.toml / Cargo.toml / go.mod with build + test scripts
4 ci_workflows 10 .github/workflows/, GitLab CI, CircleCI, Azure Pipelines, Travis, or Jenkinsfile
5 test_directories 10 test/ / tests/ / __tests__/ / spec/ dirs or *.test.* / *.spec.* files
6 lint_typecheck 10 npm scripts, ESLint/Biome/Ruff/mypy/pyright config, or tsconfig.json
7 archon_workflows 10 .archon/workflows/ with at least one YAML file
8 security_scanning 10 Dependabot, Renovate, security CI workflow, or audit script
9 sensitive_paths 10 auth/ / billing/ / infra/ / secrets/ dirs (7pt) + .env in .gitignore (3pt)
10 markdown_report 10 Always passes when this workflow runs

Rating bands

Score Rating
90–100 Agent-ready
75–89 Mostly ready
60–74 Partially ready
40–59 Risky
0–39 Not harnessed

Install