claude-skills/engineering/agent-harness
Claude a80eec2267
fix: rename all remaining built-in-shadowing skill names and harden the last cp1252-fatal scripts (#885, #969 follow-through)
Round-2 sweep after re-auditing all 15 reported issues against the merged dev:

- #885 generalized: the original fix only renamed self-improving-agent's
  status/review, but three more plugins shipped skills whose bare names
  shadow Claude Code built-ins. Renamed with the same convention:
  playwright-pro init/review -> pw-init/pw-review, agenthub init/status ->
  hub-init/hub-status, autoresearch-agent status/resume -> ar-status/
  ar-resume. All command references (/pw: /hub: /ar:), docs, audit records,
  harness manifests, and mirror trees/indexes updated; the flat mirror
  namespace no longer collides on 'status'. New scripts/check_skill_names.py
  gate (wired into ci-quality-gate.yml as blocking) fails CI on any future
  bare reserved name; rule added to SKILL-AUTHORING-STANDARD.md.
- #969 follow-through: five more scripts print box-drawing characters that
  cannot exist in cp1252 (api_scorecard, api_linter,
  breaking_change_detector, humanizer_scorer, content_scorer) — same
  guarded UTF-8 reconfigure applied; all smoke-tested under a forced
  legacy encoding.

Verified: check_skill_names (incl. negative test), check_plugin_json,
check_paths, derive_counters, check_dual_publish, smoke_scripts (634/634),
0 broken mirror symlinks.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Qgc6RYXWJPr5oW9DHU7zR4
2026-08-21 08:38:50 +00:00
..
.claude-plugin feat(engineering): agent-harness skill + agentic-readiness audit of both engineering domains 2026-07-03 06:01:43 +00:00
agents feat(engineering): agent-harness skill + agentic-readiness audit of both engineering domains 2026-07-03 06:01:43 +00:00
commands feat(engineering): agent-harness skill + agentic-readiness audit of both engineering domains 2026-07-03 06:01:43 +00:00
skills/agent-harness fix: rename all remaining built-in-shadowing skill names and harden the last cp1252-fatal scripts (#885, #969 follow-through) 2026-08-21 08:38:50 +00:00
README.md feat(engineering): agent-harness skill + agentic-readiness audit of both engineering domains 2026-07-03 06:01:43 +00:00

agent-harness

Turn any domain folder of this repo into a bounded agentic loop: pick up a goal, compile it into tasks with machine-run verification, execute, verify, retry with caps, escalate to a human when budgets exhaust, and close only when everything is verified.

GOAL → goal_compiler → PLAN → loop_controller: [execute → verify]* → CLOSE
                                     ↑ retry ≤ caps, changed approach
                                     └ ESCALATE — never fake success

What ships

Piece Purpose
scripts/harness_manifest_builder.py Scan a domain folder → manifest.v1 JSON (skills, tools, checks, agentic signals)
scripts/goal_compiler.py Goal + manifest → plan.v1 task plan; refuses vague goals (exit 3, forcing questions)
scripts/loop_controller.py init/next/record/verify/close/status state machine; controller runs checks itself
assets/harnesses/*.json 18 committed per-domain manifests (regenerable, diff-stable)
assets/harness_manifest.schema.json Manifest schema
references/ Agentic-loop canon, verification discipline, domain-harness design (cited)
agents/harness-runner.md Stateless one-task-per-invocation executor
commands/cs-harness.md /cs:harness <domain> <goal> end-to-end driver

All tools are stdlib-only, pass --help and --sample, and emit JSON.

Design lineage

Anthropic's long-running-agents harness (feature-list + stateless shifts), verifier's law, SWE-agent's environment-feedback lesson, Ralph-loop fresh-context iteration, Cognition's serialize-writers rule, and this repo's own tc-tracker / autoresearch locked-evaluator / loop-library stop-state primitives. See skills/agent-harness/references/.