ChatGPTClaudeGrok / X / CursorGemini

opencode-dev-framework: Proof-of-Done Enforcement for DeepSeek Harness Agents

jwitmann/opencode-dev-framework

Development & OperationsVerified
Listed on 2026-11-18
Page last updated 2026-11-19

Adds enforcement gates to AI coding agents on DSH and OpenCode: pre-edit guardrails, per-edit lint feedback, and a completion gate that demands real proof of done.

opencode-dev-framework is an enforcement plugin for DeepSeek Harness that replaces an agent's verbal claim with verifiable evidence. It targets the common failure of AI agents declaring a task finished without any check: edits are validated against guardrails before they land, each changed file gets formatting and lint feedback, and a completion gate runs real typecheck and tests when the session ends. One shared config, profiles, rules and gates serve both DSH and OpenCode, written in TypeScript under the MIT license.

How to Install

install
npmdsh plugin --profile <your-profile> add opencode-dev-framework

Replace --profile with the profile name you actually run (see ls ~/.dsh/profiles/): usually web in the browser UI, desktop or desktop-NNN in the desktop app.

Category
Development & Operations
Platform
DSH Plugin
Author
jwitmann
Distribution
Plugin

opencode-dev-framework Key Features

Pre-edit guardrail blockingPer-edit lint feedbackCompletion gate runs real checksGoals need tool-result PASSShared config across both hosts
Listed on dsh-plugin.org

opencode-dev-framework Repo Summary

What Does It Do?

opencode-dev-framework is a DSH plugin for DeepSeek Harness that turns "the agent says it is done" into "the agent proves it is done". It solves the problem of AI coding agents declaring completion without evidence: edits are checked against guardrails before they land, each changed file gets formatting and lint feedback, and a completion gate runs your real typecheck and tests when the session goes idle. One shared enforcement core powers native adapters for both DSH and OpenCode with the same config, profiles, rules and gates; it is written in TypeScript and released under the MIT license by jwitmann.

Core Features

  • Completion gate: runs your project's real typecheck and tests before the session terminates, and a failing exit code keeps the work going in the same turn.
  • Per-edit lint: runs the linter on each edited file right after the edit lands, and on DSH it fails the tool call so the agent retries in the same turn.
  • Guardrails: checks edits against rules before they land; warn-level findings are logged, can be escalated to a human prompt when the approval seam is injected, and redirect targets are guard-checked too.
  • Verified goals: require a tool-result PASS on the final tree instead of accepting the agent's assertion.
  • Config scaffolding: the init command detects your project, writes a config and templates, trial-runs them, and hands you a hardening draft to review.
  • Dual-host adapters: the same enforcement core wires skills directories and reviewer subagents differently per host, so DSH and OpenCode each get native behavior.

How to Use This Plugin?

After enabling it in DSH, run the init command inside your project: it detects the project layout, writes a config, trial-runs the checks, and hands the session agent a brief with what was detected and at most three open questions, ending with a config plus a hardening draft for your review in about five minutes. Then ask the agent for a small edit to see it work: the edit is guard-checked before landing, the linter runs on the edited file, and the completion gate runs typecheck and tests when the session goes idle. A status command shows the live state at any time; start with the advisory profile if you want to observe before enforcing.

How to Troubleshoot This Plugin?

If init hits existing files, follow the official guidance to overwrite or skip them, and check the init command's help for the remaining options. On DSH, run from the project root or set the working directory explicitly; if the session reports template drift, accept the template changes with the update command as described in the official docs.

This page is an independent rewrite of the plugin's official README — for authoritative documentation and the latest changes, refer to the source: jwitmann/opencode-dev-framework. The plugin is third-party code that runs on your machine once installed; inclusion does not imply endorsement — please review the source before installing.

Install, update, and uninstall this plugin in the Plugin Market of DeepSeek Harness's DSH Plugin Hub
ChatGPTClaudeGrok / X / CursorGemini

DSH Plugin FAQ