dsh-engineering-workflow

dsh-engineering-workflow

An engineering workflow layer for DeepSeek Harness (dsh). One install adds the 工程工作流 (Engineering Workflow) agent preset — a disciplined-engineer mode with five hard-gated phases — plus six workflow skills that carry the methodology.

The workflow methodology is adapted from obra/superpowers (MIT): brainstorming, writing-plans, TDD, subagent-driven development, and verification-before-completion, reworked for dsh's native tools (plan mode + exit_plan_mode, background subagent/subagent_fork, workflow orchestration, goals, and the preset/skill system).

The five phases

Phase	Skill	Gate	dsh mechanism
① Requirements clarification	workflow-requirements	Intent approved before any code	ask_user_question, one question at a time
② Plan approval	workflow-planning	Plan approved via exit_plan_mode	plan mode, todo_write after approval
③ TDD implementation	workflow-tdd	Failing test before production code	pwsh/bash test runs
④ Parallel subagent execution	workflow-subagents	Per-task review + ledger	background subagent, send_message, list_agents
⑤ Verified finishing	workflow-verification	Fresh evidence before claims	full suite + branch-finish menu

The master skill engineering-workflow routes every non-trivial task to the right phase and enforces the discipline rules (rationalization red flags included).

Install

dsh plugin --profile <name> add github:82c86b8z86-stack/dsh-engineering-workflow

(Or npm install the package into your profile and add dsh-engineering-workflow to dsh.profile.bundles.)

Restart dsh once so the host plugin mounts. On startup it syncs the preset into ~/.dsh/.agent-presets/engineering-workflow; the preset then appears in the new-session preset picker as 工程工作流. The sync is idempotent — upgrading the plugin updates the preset and its skills automatically.

Manual / development fallback without a restart:

node scripts/sync-presets.mjs

dsh re-discovers presets on every roster read, so the synced preset is selectable immediately.

How it works

dsh-engineering-workflow (bundle)
├── cordis.patch.yml        inserts one host plugin row
└── lib/index.js            host plugin: syncs presets/ → ~/.dsh/.agent-presets,
│                           announces the workflow via a system-prompt section
└── presets/engineering-workflow/
    ├── agent.cordis.yml    full toolset composition (adapted from the shipped
    │                       cordis preset, MIT): shell, filesystem, jobs, goals,
    │                       plan mode, compaction, delegation (subagent/subagent_fork/
    │                       workflow/ralph), ask-user, todo, web, skills
    ├── preset.yml          roster metadata (name / description / order)
    ├── skills/             6 workflow skills (one SKILL.md per directory)
    └── NOTICE              attribution

The preset wires its skills through @deepseek-ai/dsh-skill-filesystem with customSkillDirs rooted at the preset's own directory — the same pattern the shipped cordis preset uses, so the skill catalog travels with the preset wherever it is installed.

Verify the install

node scripts/verify-install.mjs
# ✓ engineering-workflow: current (byte-identical)

This compares the bundled preset against ~/.dsh/.agent-presets without writing anything. If it reports stale or missing, run node scripts/sync-presets.mjs (or restart dsh once so the host plugin syncs on mount).

Where the plugin takes effect:

• The preset picker (new-session dialog) lists 工程工作流 — dsh re-discovers presets on every roster read, so a synced preset appears without a restart. Pick it for a new session; existing sessions and the default preset are never switched.
• The system-prompt announcement (the workflow guidance the model reads) appears in sessions created after the host plugin mounted — i.e. after the first dsh restart following the install.
• The six workflow skills load with the preset and are invocable via the skill tool in those sessions.

Development

pnpm install
pnpm test          # preset-sync unit tests
pnpm run validate  # structural validation of the bundled preset
pnpm run sync      # sync the preset into ~/.dsh/.agent-presets
pnpm run verify    # byte-compare the bundled preset against the install

License

MIT. The preset composition is adapted from the DeepSeek Harness built-in cordis preset (MIT); the workflow methodology is adapted from obra/superpowers (MIT); the preset-sync host-plugin pattern follows @linxin666/dsh-liangshen (Apache-2.0). See presets/engineering-workflow/NOTICE.