lonelymoon87/dsh-specflow

dsh-specflow

Specification-driven development for DeepSeek Harness, built from native skills, commands, goals, tools, and runtime context.

The installable v0.1.2 release targets DSH 0.1.0-rc.6. This project currently distributes prebuilt packages through GitHub Releases and is not published on npm.

简体中文

Why SpecFlow

SpecFlow keeps requirements, design decisions, and task progress in reviewable workspace files instead of relying on one chat’s memory. A durable DSH goal represents the whole specification, while tasks.md remains the authoritative record for individual work items.

The MVP provides:

• five portable skills: constitution, specify, plan-spec, tasks, and implement;
• four discoverable UI commands: /specify, /plan-spec, /tasks, and /implement;
• a specflow_status tool that reads checkbox progress from tasks.md;
• goal creation and explicit resume for /implement;
• active goal and task progress in DSH runtime context;
• templates for spec.md, plan.md, and tasks.md.

Artifact protocol

.dsh/
├── memory/
│   └── constitution.md
└── specs/
    └── 001-example-feature/
        ├── spec.md
        ├── plan.md
        └── tasks.md

The spec directory is the durable source of truth. SpecFlow does not add a required custom session event or maintain a second hidden task database.

Install

The package currently targets the DSH 0.1.0-rc.6 plugin APIs and Node.js ^22.19 || >=24.

dsh plugin --profile web add https://github.com/lonelymoon87/dsh-specflow/releases/download/v0.1.2/dsh-specflow-0.1.2.tgz

The release tarball is prebuilt and needs no build allowance. A pinned source install is also supported:

dsh plugin --profile web add github:lonelymoon87/dsh-specflow#v0.1.2

The source install runs this package’s prepare build. pnpm 10 and later reject it until the profile allowlists the exact package key printed by the failed command; apply that instruction and rerun the same dsh plugin add command. Replace web with headless to install into the one-shot agent profile.

To upgrade, rerun dsh plugin add with the newer release URL. To uninstall:

dsh plugin --profile web remove dsh-specflow

After installation, start DSH with the same profile and use:

/constitution Require focused tests for every behavior change
/specify Add resumable exports to the CLI
/plan-spec 001-resumable-exports
/tasks 001-resumable-exports
/implement 001-resumable-exports

Configuration

The bundle inserts the plugin with defaults. A profile may configure the plugin entry directly:

- id: specflow
  name: dsh-specflow
  config:
    specsDir: .dsh/specs
    autoInjectContext: true

specsDir may be workspace-relative or absolute. autoInjectContext controls only the model-facing progress snapshot; it does not change goal or artifact behavior.

Design constraints

• Exports are named only; no default export is mixed into the Loader module.
• All registry contributions use the owning DSH service’s effect-backed register() method.
• Commands enqueue an explicit user skill invocation so the skill loader remains the single owner of method instructions.
• /implement refuses to replace an unrelated active goal.
• Task completion is counted only from Markdown checkbox lines.

Release evidence

• The v0.1.2 tarball installs directly from its HTTPS release URL into a clean DSH profile.
• The packed bundle and pinned GitHub source install both appear in dsh --dump-config.
• CI covers Node 22.19 and Node 24; a scheduled workflow repeats the real install against @deepseek-ai/dsh@latest.
• Bugs and compatibility reports are tracked in GitHub Issues.

License

MIT