harness-doctor

Solid

Scans a project's harness structure (.claude/ directory, CLAUDE.md, rules, agents) to diagnose complexity, drift, missing files, and broken references, then suggests improvements. `--lint` flag adds language-pattern scan (self-marketing, cushion words, version brags). Triggered by "harness check", "structure diagnosis", "CLAUDE.md audit".

AI & Automation 8 stars 0 forks Updated today MIT

Install

View on GitHub

Quality Score: 79/100

Stars 20%
32
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# harness-doctor — Harness Structure Diagnosis + Prescription "A good harness gets simpler over time. If it's getting more complex, something is wrong." Diagnoses harness structural health across 5 layers and proposes M/S/R prescriptions: 1. **L1 Structural completeness** — required file existence (CLAUDE.md · .claudeignore · .claude/) 2. **L2 Complexity** — current state vs. simplification principle (line count · unused files · duplicate definitions) 3. **L3 Drift** — rule vs. actual pattern mismatch (broken references · stale files · conflicting rules) 4. **L4 Connection diagnosis** *(FH environment only)* — meta hub ↔ field project reference consistency 5. **L5 Pattern analysis** *(FH environment only)* — skill activity · call context appropriateness · effect metrics --- ## Execution Steps ### Step 1. Confirm Diagnostic Target Check current cwd harness file structure and determine if FH environment (tracks/ + knowledge/ + plugins/ all present). ### Step 2. L1 — Structural Completeness | File | When Missing | |---|---| | `CLAUDE.md` | **M-tier** — harness entry impossible | | `.claudeignore` | S-tier — context-doctor execution recommended | | `.claude/` directory | M-tier (when rule files exist) | ### Step 2-E. L1-E — ETCLOVG Layer Coverage *(functional-layer lens — orthogonal to the file-presence table above)* A harness is not only files; it is **seven functional layers** (ETCLOVG — arXiv:2606.06324, a component taxonomy *orthogonal* to FH's 6-axis process model...

Details

Author
chrono-meta
Repository
chrono-meta/forge-harness
Created
2 months ago
Last Updated
today
Language
Shell
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

harness-doctor

Check whether this project's Agentsmith harness is installed correctly and healthy — fires on "is my harness set up right?", "harness doctor", "check my harness". Part of the Agentsmith harness; runs self-contained health checks (CLAUDE.md managed block, settings, verify.conf, scripts, leanness) with a one-line fix for each finding.

255 Updated 3 days ago
PromptPartner
Code & Development Listed

harness-health-audit

Audit the health of an AI-coding harness — the CLAUDE.md / AGENTS.md files, rules, skills, agents, hooks, and commands that steer an agent in a repository — across four questions a linter cannot answer: is it TRUE (does it match the real code?), is it USED (do skills actually trigger and does the loop actually verify?), is it AFFORDABLE (is it inside the budget where instructions are still followed?), and is it SAFE (is a live, accurate instruction still a good idea — permission bypasses, unpinned remote scripts, untrusted content flowing in as instructions? — safety findings are flagged for the user's decision, never auto-removed). Then surgically correct or remove only what is proven wrong or dead. Use whenever the steering layer may have rotted or may not be working: "하네스 점검해줘", "하네스 드리프트 감사", "CLAUDE.md가 실제랑 맞는지 봐줘", "룰/스킬이 최신인지 확인해줘", "스킬이 제대로 활용되는지 봐줘", "루프 엔지니어링 잘 되고 있는지 검토해줘", "죽은 훅/커맨드 정리해줘", "하네스 안전한지 점검해줘", "audit my harness", "check the rules still match the real stack", "are my skills actually be

3 Updated today
uzysjung
AI & Automation Solid

harness-audit

Score a project's agent harness across 5 subsystems (Instructions / State / Verification / Scope / Lifecycle), identify the bottleneck, and produce a prioritized improvement plan. Use when assessing if a project is ready to graduate to [LONG-RUN] status, when an agent keeps failing despite good models, or when adopting our stack on a new codebase. Do NOT use to design or build a new harness from scratch — this only scores an existing one; for greenfield harness/agent architecture use harness-design (or agent-harness-design).

138 Updated today
AnastasiyaW