scriptoriumadmin/claude-skills
1
0
Fork 0
mirror of https://github.com/alirezarezvani/claude-skills.git synced 2026-09-07 08:26:02 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
claude-skills/engineering/agent-harness/README.md
Claude 0a5d18ceba
feat(engineering): agent-harness skill + agentic-readiness audit of both engineering domains 
Deep-audit both engineering folders (engineering/ + engineering-team/) against the
June 2026 baseline and score every skill on a new 6-dimension agentic-readiness rubric
(goal intake, decomposition, deterministic execution, verification, loop discipline,
close-out). Combined: 26 HARNESS-READY, 39 LOOP-CAPABLE, 43 TOOL-ONLY, 7 PROSE-ONLY.
Headline finding: loop discipline (AR5) is the repo-wide gap.

Ship engineering/agent-harness — the thin unifying layer that turns any of the repo's
18 domains into a bounded, self-verifying agent loop:
- harness_manifest_builder.py: scan a domain -> manifest.v1 (skills, tools, checks, signals)
- goal_compiler.py: goal + manifest -> plan.v1; refuses vague goals (exit 3) / no-match (4)
- loop_controller.py: init/next/record/verify/close state machine; runs checks itself via
  subprocess (no verification theater), caps attempts+iterations with escalation, refuses
  to close while any task is unverified; atomic state writes
- 18 committed per-domain manifests, JSON schema, harness-runner agent, /cs:harness command,
  3 references citing the 2024-2026 harness canon
- reuses agenthub / autoresearch locked-evaluator / tc-tracker / loop-library primitives

Audit record under audit/engineering-agentic-2026-07/ (master + 2 domain reports +
improvement-fields rollup + research digest + rubric).

Counters: 82->83 plugins, 354->355 skills, 593->596 tools, 722->725 refs (derive_counters
--check passes). All CI gates green: plugin.json, smoke --help/--sample, JSON output,
path linter, dual-publish, counters.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01L4JerbGv6vqitUMhqHPA9g
2026-07-03 06:01:43 +00:00

1.7 KiB
Raw Permalink Blame History

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/.