dsh-spec-gate
Specification gate plugin for DeepSeek Harness (dsh). Turns vague requirements into locked, verifiable specifications before work begins — and refuses to hand over deliverables that don't meet them.
Borrows two ideas from Ouroboros, adapted for content production (writing / analysis / reports):
- Interview gate: vague request → Socratic questioning to expose hidden assumptions → ambiguity score (converged at ≤ 0.2 before proceeding)
- Acceptance gate: before delivery, mechanically check the draft against the locked Seed (keyword coverage, hard constraints, word count) + semantic alignment hint for the agent
Pairs with dsh-cybernetics: acceptance failures are written to the events log and feed the cybernetic feedback loop.
Tools
| Tool | Purpose |
|---|
spec_interview_assess | Ambiguity scoring: judge 8 dimensions (audience / purpose / format / data / scope / tone / acceptance / deadline) as clear / assumed / missing; returns score + questions to ask |
spec_seed_build | Lock an immutable Seed (goal / dimensions / acceptance criteria / constraints) after the interview converges; hash-keyed, never overwritten |
spec_gate_evaluate | Pre-delivery acceptance: mechanical checks against the Seed + AC coverage hints; fails closed |
Install
dsh plugin --profile web add github:boomzikazita/dsh-spec-gate
Configure
# cordis.patch.yml (or the plugin's own bundle patch)
- insert:
- id: spec-gate
name: 'dsh-spec-gate'
config:
seedsDir: '~/.dsh/spec-gate/seeds'
eventsLog: '~/.dsh/spec-gate/events.jsonl'
convergeThreshold: 0.2
hardGate: false # block write/edit before a Seed exists (default off)
Usage Flow
- Vague request arrives → run
spec_interview_assess → clarify missing dimensions until score ≤ 0.2
- Lock the spec:
spec_seed_build → returns seed_id
- Produce the deliverable
- Verify:
spec_gate_evaluate(draft, seed_id) → only hand over on pass
License
MIT
