Automaton Guard Plugin
Harness: OpenCode (@opencode-ai/plugin)
Status: Active
Enforcement: Pre-edit (tool.execute.before)
Blocks file modifications (edit, write tools) when no automaton task is in
implement or doc_review phase. Calls status.py --can-edit --file <path> --json
before every edit.
Installation
The framework install/update scripts auto-register this plugin in
~/.config/opencode/opencode.json (or opencode.jsonc):
{
"plugin": ["~/.automaton/plugins/automaton-guard"]
}
Other Harnesses
| Harness | Plugin | Status |
|---|---|---|
| OpenCode | plugins/automaton-guard/plugin.ts |
✅ Active |
| Pi Dev | plugins/automaton-guard-pi/guard.ts |
✅ Active |
| Other | N/A | N/A |
To add support for a new harness, create a plugin in plugins/ that calls
status.py --can-edit --file <path> before tool execution, matching the
contracts/harness-integration.md specification.
Enforcement Layers
| Layer | Mechanism | Harness scope |
|---|---|---|
| Pre-edit | This plugin | OpenCode only |
| Pre-commit | scripts/git-hooks/pre-commit |
All git projects |
| Pre-push | scripts/git-hooks/pre-push |
All git projects |