jiezeng2004-design/dsh-requirements-alignment

dsh-requirements-alignment

Stop long-running agents from quietly changing what you asked for.

让 DSH Agent 自己做工程决策，但别让它在长任务里悄悄改需求、扩范围、换架构。

dsh-requirements-alignment is a lightweight runtime drift guard for DeepSeek Harness (DSH). It turns the user's intent into a durable requirement baseline, stays out of the way while the agent works, and only interrupts when the next step would materially change the direction.

You decide the direction. The agent decides the engineering.

Current release candidate: v0.5.0-rc.1, targeting DeepSeek Harness 0.1.7-rc.2. Requires Node.js >=22.18.0. See the compatibility report for verified behavior and limits.

The problem

Long-running coding agents are good at keeping momentum. That is also how they can drift.

A task may start as:

Fix the result-page filter.
Do not refactor backend logic.

Later the agent discovers that a cleaner solution would require backend changes. Without an explicit guardrail, it may simply expand the scope and continue.

Requirements Alignment changes that behavior:

User intent
   ↓
Durable requirement baseline
   ↓
Agent works normally
   ↓
Direction-changing step detected?
   ├─ No  → keep working silently
   └─ Yes → ask once → record decision → continue

What counts as drift

The plugin is interested in direction-level changes, not implementation trivia.

Typical drift candidates include:

• expanding or shrinking the approved scope;
• violating an explicit constraint;
• changing user-visible behavior;
• switching architecture or product form;
• invalidating a settled assumption;
• changing a previously approved user decision;
• taking a destructive path that changes the intended outcome.

It should not stop the agent to ask about variable names, helper placement, ordinary refactors inside the approved scope, or other routine engineering choices.

Requirements Alignment vs Plan Mode

Plan Mode asks:
"Is this the right implementation plan?"

Requirements Alignment asks:
"Are we still solving the right problem?"

Plan Mode helps before implementation starts. Requirements Alignment protects intent during execution.