agent-harness plugin
Make your own agent setup reliable: instruction files that are met at the moment they apply, rules held by hooks instead of prose, status that survives context compaction, the handover the next session starts from, a session's friction turned into a setup fix, and the Windows shell traps that break agents.
How to install the agent-harness plugin
Run both commands inside Claude Code. The first adds the marketplace once; the second installs the plugin.
/plugin marketplace add phuryn/product-engineering
/plugin install agent-harness@product-engineeringWhat's inside agent-harness
6 parts read from the plugin's own files.
Skills 6
Claude loads it when the task matches- agent-instructions
Writing or restructuring AGENTS.md or CLAUDE.md, adding a rule ('remember this'), or after an agent ignored a rule it had: make each rule get met when it applies.
- flight-deck
'What's the status', 'where were we', a progress report or status deck; long work that must survive compaction: multi-hour runs, background jobs, waiting on a decision.
- guardrail-hooks
An agent keeps breaking a rule ('it did it again', 'make this impossible', 'add a hook', 'my hook didn't fire'): make it a hook, permission rule or script.
- handover
Write the handover a fresh session starts from: the objective, what is true now, the evidence actually obtained, what is left, the open decisions and the next concrete action, reconciled with the disk first. Started by name only: /agent-harness:handover in Claude Code, $agent-harness:handover in Codex.
- retro
Build a session's learnings into the setup: its friction, what went wrong and why, then an improved instruction, route, hook or script, verified, or 'no setup change warranted'. Started by name only: /agent-harness:retro in Claude Code, $agent-harness:retro in Codex.
- windows-agent-shell
A coding agent on Windows: Git Bash path rewriting, PowerShell quoting and encoding, CRLF. Use when output comes back garbled, or it works here and breaks there.
Using agent-harness in Claude Code
Skills need no command. Claude reads them when your request matches what they describe.
Update, turn off or remove
- Update the plugin (shell)
- claude plugin update agent-harness@product-engineering
- Refresh the marketplace
- /plugin marketplace update product-engineering
- Turn it off for now
- /plugin disable agent-harness@product-engineering
- Remove it
- /plugin uninstall agent-harness@product-engineering
Skills in agent-harness
- agent-instructionsphuryn/product-engineering
Writing or restructuring AGENTS.md or CLAUDE.md, adding a rule ('remember this'), or after an agent ignored a rule it had: make each rule get met when it applies.
9 files609stars - flight-deckphuryn/product-engineering
'What's the status', 'where were we', a progress report or status deck; long work that must survive compaction: multi-hour runs, background jobs, waiting on a decision.
5 files609stars - guardrail-hooksphuryn/product-engineering
An agent keeps breaking a rule ('it did it again', 'make this impossible', 'add a hook', 'my hook didn't fire'): make it a hook, permission rule or script.
6 files609stars - handoverphuryn/product-engineering
Write the handover a fresh session starts from: the objective, what is true now, the evidence actually obtained, what is left, the open decisions and the next concrete action, reconciled with the disk first. Started by name only: /agent-harness:handover in Claude Code, $agent-harness:handover in Codex.
3 files609stars - retrophuryn/product-engineering
Build a session's learnings into the setup: its friction, what went wrong and why, then an improved instruction, route, hook or script, verified, or 'no setup change warranted'. Started by name only: /agent-harness:retro in Claude Code, $agent-harness:retro in Codex.
3 files609stars - windows-agent-shellphuryn/product-engineering
A coding agent on Windows: Git Bash path rewriting, PowerShell quoting and encoding, CRLF. Use when output comes back garbled, or it works here and breaks there.
4 files609stars
agent-harness plugin questions
How do I install the agent-harness plugin?
In Claude Code run /plugin marketplace add phuryn/product-engineering, then /plugin install agent-harness@product-engineering.
What does the agent-harness plugin include?
agent-harness bundles 6 skills.
How do I update or remove the agent-harness plugin?
Update it with claude plugin update agent-harness@product-engineering in your shell, or from the Installed tab of /plugin. Remove it with /plugin uninstall agent-harness@product-engineering.
What license is the agent-harness plugin under?
MIT, as stated in the plugin's manifest.