Agent Harness Doctor

Based on Anthropic's "Effective Harnesses for Long-Running Agents" and ClawHub's agent-harness-architect, this skill automatically diagnoses and hardens your OpenClaw harness.

The 8 Dimensions

Usage

Run Diagnostic

tool("agent-harness-doctor", "harness_check", {"fix_apply": []})

Output includes:

{
  "summary": {
    "score": 6.5,
    "grade": "B",
    "weakest_dimension": "Session Bridge"
  },
  "dimensions": [
    {
      "id": "session_bridge",
      "name": "Session Bridge",
      "score": 2,
      "max": 10,
      "finding": "No agent-progress.json file found",
      "recommendation": "Create agent-progress.json with lastSession, taskTracking, environmentStatus sections",
      "p0": true
    },
    ...
  ],
  "plan": {
    "P0": ["create_session_bridge", "fix_startup_sequence"],
    "P1": ["add_smoke_test", "enable_atomic_checkpoint"],
    "P2": ["output_verification_gate", "multi_agent_protocol"]
  }
}

Auto-Apply P0 Fixes

tool("agent-harness-doctor", "harness_check", {"fix_apply": ["create_session_bridge", "fix_startup_sequence"]})

The tool will:

1. Create agent-progress.json in workspace root with template
2. Update AGENTS.md or CLAUDE.md to include a fixed startup sequence section
3. Log changes made

Apply Single Fix

tool("agent-harness-doctor", "apply_fix", {"fix_id": "create_session_bridge"})

Fixes Implemented

• create_session_bridge — generates agent-progress.json with schema v1.0
• fix_startup_sequence — inserts mandatory startup steps into AGENTS.md (if present)
• add_smoke_test — adds pre-task environment check (gateway status, API connectivity)
• enable_atomic_checkpoint — adds post-task commit template
• output_verification_gate — injects self-check prompt into system instructions
• state_json_format — migrates existing state files from MD to JSON
• fallback_plan_template — adds fallback handling patterns to AGENTS.md

Integration with Memory Stack

If memory-stack-core is installed, harness doctor will:

• Check WAL and buffer health as part of "Session Bridge" score
• Recommend enabling WAL auto-capture if missing
• Verify buffer threshold is set appropriately

Pricing

$99 one-time. Includes:

• Unlimited diagnostics
• Auto-fix application
• Future dimension additions

Based on ClawHub's agent-harness-architect skill, extended with auto-fix capabilities.