debug-my-harness

Solid

Diagnose why an agent harness misbehaved by reading the local flight-recorder ledger (.vigiles/runs.jsonl) — which skills fired or got hijacked, which hooks blocked or wrongly allowed, which subagent tool-contract violations happened, and how a skill's trigger rate moved. Use when asked why a skill stopped firing, why a hook didn't block, why the wrong skill ran, or to debug/investigate what the harness actually did. NOT for writing new rules (use strengthen) or editing the spec (use edit-spec).

Code & Development 13 stars 1 forks Updated today MIT

Install

View on GitHub

Quality Score: 80/100

Stars 20%
38
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

Diagnose harness misbehavior from the **flight recorder** — the local, append-only ledger at `.vigiles/runs.jsonl` that vigiles writes as your harness runs. It records what actually happened, so you debug from evidence instead of guessing. ## What's in the ledger One JSON record per line, each with a `kind`: - `hook` — a compiled-hook gate decision: `{event, decision: allow|deny|ask, mode: enforce|observe, rule, cmd, reason}`. - `agent` — a subagent tool-contract decision: `{name, tool, allowed, reason}` (a `false` = the agent went outside its lane). - `skill` — a skill activation: `{name, fired}`. - `eval` — a measured metric: `{name, metric, value}` (e.g. trigger-rate recall/precision). - `capability-diff` — a blast-radius change: `{pr, added, removed, widened}`. ## Instructions ### Step 1: Read the ledger Read `.vigiles/runs.jsonl` (JSONL — one record per line; tolerate a torn last line). If it's absent or empty, say so — there's nothing recorded yet; suggest running the harness (or `vigiles audit`) first. Do NOT fabricate records. ### Step 2: Answer the specific question, evidence-first Match the user's question to the ledger: - **"Why did skill X stop firing / why does the wrong one run?"** — count `skill` fires by name over time. If X's fire-rate dropped, look for a sibling that fired on the same kinds of prompts (a **selection collision**) and check their descriptions for overlap. Recommend differentiating or merging the descriptions. - **"Why didn't my ...

Details

Author
zernie
Repository
zernie/vigiles
Created
4 months ago
Last Updated
today
Language
TypeScript
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

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-help

Orient a non-coder to this project's Agentsmith harness — fires on "what is this harness?", "what are my rules?", "which profile am I on?", "what do I type next?". Part of the Agentsmith harness; reads CLAUDE.md and reports the active profile, a short rules summary, the safety mode, and the next thing to type — in plain language.

255 Updated 4 days ago
PromptPartner
AI & Automation Listed

harness-eng

Use when designing, evaluating, or simplifying an agent project harness: AGENTS.md/CLAUDE.md rules, startup scripts, progress logs, feature trackers, handoffs, evaluator rubrics, quality documents, repo-local knowledge maps, and mechanical guardrails for coding agents. Especially useful when converting raw agent-workflow notes into a concise, verifiable project control layer.

3 Updated yesterday
MasihMoafi