dsh-matt-pipeline

Readme

# dsh-matt-pipeline

**English** | [简体中文](README.zh-CN.md)

Matt Pocock's skill workflow pipeline for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH).

The bundled skills come from Matt Pocock's [mattpocock/skills](https://github.com/mattpocock/skills) repository — all credit for the skill content goes to him.

![Pipeline panel in the DSH sidebar](preview.png)

- **Server half**: registers the bundled matt skill set (`matt-triage`, `matt-grill-me`, `matt-to-spec`, `matt-to-tickets`, `matt-tdd`, `matt-code-review`, `matt-research`, `matt-diagnosing-bugs`, …) as model- and user-invocable DSH skills.
- **Browser half**: adds a **🔀 Pipeline** tab to the [dsh-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar) showing the workflow

  `💡 Idea → 🔍 Triage → 🔥 Grill → 📝 Spec → 🎫 Tickets → ⚡ Implement → ✅ Review`

  plus auxiliary tools (🐛 Debug / 📚 Research / 🎓 Teach / 📦 Handoff / ❓ Ask Matt). Clicking **Start** dispatches the official `/<skill>` gesture straight into the active session (clipboard fallback if the connection API is unavailable).

## Requirements

- A DSH web or desktop profile with [`dsh-better-sidebar`](https://github.com/omdsh-dev/DSH-better-sidebar) installed (the pipeline panel registers into it; the skills work without it).

## Install

```bash
dsh plugin --profile web add https://github.com/sa998aaron/deepseek-harness-matt-plugin.git
```

For the DSH Desktop GUI use the `desktop` profile:

```bash
dsh plugin --profile desktop add https://github.com/sa998aaron/deepseek-harness-matt-plugin.git
```

Then restart DSH (or toggle the plugin off/on in **Settings → Plugins**) and hard-refresh the page (Ctrl+F5).

### Manual install

1. Clone this repo into `<profile>/node_modules/dsh-matt-pipeline` (e.g. `~/.dsh/profiles/desktop/node_modules/`).
2. In `<profile>/package.json` add the dependency and the bundle entry:
   ```json
   "dependencies": { "dsh-matt-pipeline": "file:./node_modules/dsh-matt-pipeline" },
   "dsh": { "profile": { "bundles": [ ..., "dsh-matt-pipeline" ] } }
   ```
3. Restart DSH and hard-refresh.

The built bundles (`dist/`) are committed, so no build step is needed on install.

## Usage

1. Open the sidebar's **+** menu → **🔀 Pipeline**.
2. Click a stage to see its description and expected artifact.
3. Click **Start \<Stage\>** — the panel sends `/<skill>` to the current session and the agent follows that skill's workflow.
4. Auxiliary tools at the bottom can be triggered anytime (debugging, research, handoff, …).

The bundled skills are also available directly: type `/` in the composer and look for the `matt-*` entries, or invoke them by name in chat.

## Development

```bash
pnpm install
pnpm build      # tsdown: server ESM (dist/index.mjs) + client CJS (dist/client.cjs)
pnpm dev        # watch mode
```

Layout:

```
src/index.ts     server half: registers bundled skills (ctx.skills)
src/skills.ts    SKILL.md frontmatter parsing + registration
src/stages.ts    pipeline stages & auxiliary tools (single source of truth)
client/index.tsx browser half: registers the Pipeline tab (ctx.betterSidebar)
assets/skills/   bundled matt SKILL.md files
cordis.patch.yml profile bundle patch (mounts the plugin row)
```

Note: `ctx.betterSidebar` only exists in the **browser** cordis context — UI must live in `client/`, never in the server half.

## Acknowledgements

- **[Matt Pocock](https://github.com/mattpocock)** — the skills bundled in `assets/skills/` are taken from his [mattpocock/skills](https://github.com/mattpocock/skills) repository. This plugin only packages them for DSH and adds the visual pipeline panel; the workflows themselves are his work. Thank you, Matt!
- **[dsh-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar)** — the sidebar host the pipeline panel registers into.

## License

MIT