# harness-inspect

Audits a repo's AI agent setup for rot, gaps, and improvement opportunities, as a quick monthly check or a full quarterly audit.

Skill by Adobe. Category: Agent craft.

## Install

Project (for this project only):

```sh
npx skills add adobe/ai-repo-harness-guide --skill harness-inspect
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

Global (for every project on this machine):

```sh
npx skills add adobe/ai-repo-harness-guide --skill harness-inspect -g
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

## Tags

- Runs on your computer: It runs as a program on your machine, with your access.

## Security audits

- Gen Agent Trust Hub: Pass
- Socket: Pass
- Snyk: Pass

Installs: 1. Installs counted by skills.sh. [Open on skills.sh](https://www.skills.sh/adobe/ai-repo-harness-guide/harness-inspect)

## Source

[Open the source](https://github.com/adobe/ai-repo-harness-guide/tree/HEAD/harness-plugin/skills/harness-inspect). Checked 2026-10-10. This summary may contain AI-generated text, so it can be wrong. Check the source before you rely on it.

## SKILL.md

````markdown
---
name: harness-inspect
description: Audit an existing harness for rot, gaps, and improvement opportunities. Use monthly (health check, quick pass) or quarterly (full audit, thorough assessment), and after any agent incident, major refactor, or structural change.
metadata:
  author: https://github.com/afranken
  version: 1.0.0
  visibility: public
---

# Harness Inspect

Two modes. Choose based on available time and the trigger:

| Mode | Scope | When |
|------|-------|------|
| Health check | Quick pass | Monthly; after any structural change, `make` target rename, or harness file edit |
| Full audit | Thorough assessment | Quarterly; after an agent incident, major refactor, or new AI tool adoption |

If the health check surfaces issues, escalate to a full audit.

## Instructions

### Mode selection

Check for an argument before proceeding:

| Argument | Action |
|---|---|
| `health-check` | Run the health check directly — skip to the Health check section below |
| `full-audit` | Run the full audit directly — skip to the Full audit section below |
| *(none)* | Ask the user: *"Which mode — **health-check** (quick pass, monthly) or **full-audit** (thorough assessment, quarterly)?"* Do not assume a default. |

### Before starting (optional baseline)

Load `references/before-after-probe.md` to record current agent behavior before making changes. Run again after fixes to measure impact.

### Health check

Load `references/health-check.md` and run the prompt **twice independently** (without referencing your first pass on the second run). Compare pass/fail verdicts; resolve any disagreements. Report pass/fail for each of the ten questions and list action items only — no full analysis.

### Full audit

Load `references/full-audit.md` and run the prompt **twice independently** (without referencing your first pass on the second run). Compare verdicts; resolve disagreements. For repeat runs, fill in the inspection mode and paste the prior verdict table — the agent will produce a delta automatically.

### Processing results

| Finding type | Action |
|---|---|
| Rot | Fix immediately — stale guidance actively misleads agents |
| Critical gaps | Address before the next agent task in the affected area |
| Quick fixes | Address in the current session — they compound if deferred |
| Token optimizations | Address when convenient; reduces initialization cost over time |
| Larger improvements | Add to project backlog with the assessment date as context |

Before acting on any finding immediately (rot, quick fixes), write a specific plan — file, change, reason. If your tool supports a planning mode (e.g., Claude Code `/model opusplan`), use it for the audit run itself, then switch to execution mode for fixes.
````

- Previous: [at-upa-scripting](https://syn4pse.dev/terminal/unity-at-upa-scripting.md)
- Next: [pipeline-authoring](https://syn4pse.dev/terminal/unity-pipeline-authoring.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
