How nhangen/agent-harness works
agent-harness is a Claude Code–first configuration and enforcement harness: users provide rules, advisor personas, skills, and hooks that shape or block agent actions. A representative workflow is PR review: the review panel gathers and verifies findings, review-fix applies approved fixes and gates replies, and merge remains manual. The repository also includes rule evaluations, model benchmarking, and Obsidian-oriented session and commit capture. Relationships below follow README statements or shown imports; several skill and hook internals were not sampled.
Main entry points: agents Advisor personas · review-panel Review panel · model-matrix Model benchmark · rules Behavior rules
Components 24
Agent configuration
- Behavior rules
rules - Advisor personas
agents - Procedural skills
skills
Runtime enforcement
- Tool and turn hooks
hooks - Response gate
hooks/response-shape-gate.sh - Auditor gate
hooks/auditor-gate.sh - Git identity gate
hooks/git-identity-gate.sh
Review workflows
- Review panel
skills/review-panel - Review fix
skills/review-fix - Advisor convening
skills/convene
Evaluation
- Skill evaluations
skills/skill-evals - Model benchmark
skills/model-matrix - Deterministic grader
skills/model-matrix/scripts/grade.py - Rubric judge
skills/model-matrix/scripts/judge.py - Shared score helpers
skills/model-matrix/scripts/mm_common.py - Leaderboard ranking
skills/model-matrix/scripts/rank.py - Trust gate
skills/model-matrix/scripts/probe-gate.py
Memory and archive
- Obsidian archive
- Commit capture
hooks/obsidian-commit-capture.sh - Session save
hooks/obsidian-session-save.sh - Vault index upkeep
hooks/obsidian-vaultkeeper-tick.sh - Advisor ledgers
agents
Other components
- User
- Claude Code
Connections 23
- User → Claude Code: uses
README.md - Behavior rules → Claude Code: guides
README.md - Advisor personas → Claude Code: advises
README.md - Procedural skills → Claude Code: provides workflows
README.md - Tool and turn hooks → Claude Code: intercepts actions
README.md - Response gate → Claude Code: blocks replies
README.md - Auditor gate → Claude Code: blocks turns
README.md - Git identity gate → Claude Code: checks commits
README.md - Review panel → Review fix: passes findings
README.md - Review panel → User: presents verified findings
README.md - Review fix → User: gates replies for approval
README.md - Advisor convening → Advisor personas: selects advisors
README.md - Skill evaluations → Behavior rules: evaluates behavior
README.md - Model benchmark → Deterministic grader: scores outputs
skills/model-matrix/scripts/grade.py - Model benchmark → Rubric judge: judges responses
- Deterministic grader → Shared score helpers: imports
skills/model-matrix/scripts/grade.py - Leaderboard ranking → Shared score helpers: imports
skills/model-matrix/scripts/rank.py - Rubric judge → Trust gate: writes judgments
skills/model-matrix/scripts/probe-gate.py - Commit capture → Obsidian archive: writes commit context
README.md - Session save → Obsidian archive: saves session
README.md - Vault index upkeep → Obsidian archive: maintains index
README.md - Advisor personas → Advisor ledgers: maintain ledgers
README.md - Advisor ledgers → Obsidian archive: stores notes in
README.md