npm - @goodandready/dsh-agent-orchestrator - Versions diffs - 0.1.12 → 0.1.13 - Mend

@goodandready/dsh-agent-orchestrator 0.1.12 → 0.1.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/README.md CHANGED Viewed

@@ -1,184 +1,31 @@
-# 📦 @goodandready/dsh-agent-orchestrator
+# dsh-agent-orchestrator — deprecated
-<div align="center">
-<h3>Multi-Agent Task Decomposition, DAG Workflow Orchestration & Prompt Caching Engine for DeepSeek Harness</h3>
-<p align="center">
-  <a href="https://www.npmjs.com/package/@goodandready/dsh-agent-orchestrator"><img src="https://img.shields.io/npm/v/@goodandready/dsh-agent-orchestrator.svg?style=for-the-badge&color=6366f1&labelColor=1e1b4b" alt="npm version"></a>
-  <a href="LICENSE"><img src="https://img.shields.io/github/license/GooDAnDReaDY/dsh-agent-orchestrator.svg?style=for-the-badge&color=10b981&labelColor=064e3b" alt="license"></a>
-  <a href="https://github.com/topics/dsh-plugin"><img src="https://img.shields.io/badge/DSH-Plugin-8b5cf6.svg?style=for-the-badge&labelColor=2e1065" alt="DSH Plugin"></a>
-  <a href="https://nodejs.org"><img src="https://img.shields.io/badge/Node-20%2B-f59e0b.svg?style=for-the-badge&labelColor=451a03" alt="Node version"></a>
-</p>
-<p align="center">
-  <a href="https://goodandready.app/"><img src="https://img.shields.io/badge/All_Author_Projects-goodandready.app-ff4500.svg?style=for-the-badge&logo=rocket&logoColor=white&labelColor=1a1a2e" alt="All Author Projects"></a>
-</p>
-<p align="center">
-  <a href="README.md"><b>🇬🇧 English</b></a> •
-  <a href="README.ru.md"><b>🇷🇺 Русский</b></a> •
-  <a href="README.zh.md"><b>🇨🇳 中文说明</b></a>
-</p>
-<table align="center">
-  <tr>
-    <td align="center">
-      ⭐ <strong>If you like this plugin, please star it on GitHub</strong> — it shows me that the plugin is useful to you and motivates me to keep developing it.
-      <br><br>
-      🐛 <strong>If you find a bug or would like to request a feature</strong>, open a GitHub issue in any language — I will review your proposal and implement useful suggestions in a future plugin version.
-    </td>
-  </tr>
-</table>
-</div>
----
-## ⚡ Overview & The Problem
-Single-agent software engineering architectures suffer from cognitive overload when tasked with complex multi-stage projects: monolithic prompts conflate architecture, styling, core business logic, testing, and documentation into a single generation pass, leading to hallucinated contracts, regression bugs, and excessive token expenditure.
-Furthermore, executing multiple subagents independently often resets the LLM KV-cache on each turn, forfeiting prefix cache reuse and incurring substantial latency and financial overhead.
-**`@goodandready/dsh-agent-orchestrator`** introduces an autonomous multi-agent orchestration framework to DeepSeek Harness:
-1. **Intelligent Triage & Decomposition**: Analyzes high-level objectives from chat or Kanban cards and breaks them down into fine-grained stages across **12 specialized agent roles**.
-2. **DAG Execution Engine**: Schedules tasks based on Directed Acyclic Graph dependencies, running independent stages concurrently while strictly enforcing blocker gates.
-3. **KV-Cache / Prompt Caching Optimizer**: Guarantees byte-level prefix invariance for subagents sharing identical models, unlocking 80–90% prompt token cache hits and near-instant TTFT.
-4. **Strict Separation of Duties**: Backend implementation, UI interface design, and frontend client assembly are strictly isolated into distinct personas and execution stages.
-5. **Dual Surface Integration**: Dispatched natively via `/orchestrate` in DSH chat (with a sticky header milestone card) or via `@goodandready/dsh-kanban` task boards.
----
-## 🏗️ Architecture
-```mermaid
-graph TD
-    Trigger["Input Task<br/>(/orchestrate in Chat or Kanban Card)"] --> Main["Lead Orchestrator (Triage)"]
-    subgraph Engine ["DAG Engine & Prompt Caching"]
-        L1["Layer 1: Canonical Base Anchor (>1024 tokens)"]
-        L2["Layer 2: Shared Task Anchor"]
-        L3["Layer 3: Cumulative Artifacts (Append-Only)"]
-        L4["Layer 4: Role Suffix Directive"]
-    end
-    Main --> Engine
-    subgraph AgentPool ["Configured Agent Personas (Self-Contained in Settings)"]
-        R1["Technical Spec Analyst"]
-        R2["System Architect"]
-        R3["UI/UX Interface Designer"]
-        R4["Backend Developer"]
-        R5["Frontend Developer"]
-        R6["QA Automation Specialist"]
-        R7["Documentation Specialist"]
-    end
-    Engine --> AgentPool
-    AgentPool --> Delivery["Orchestrated Delivery<br/>(Header Utility Card & Kanban Sync)"]
-```
----
-## 👥 12 Built-In Specialized Agent Roles
-All agent profiles are **completely self-contained within plugin settings** (no external file dependencies):
-| Role ID | Title | Specialization | Strict Boundaries |
-|---|---|---|---|
-| `spec` | Technical Spec Analyst | Requirements, Acceptance Criteria (DoD), Schemas | Never writes implementation or styling |
-| `architecture` | System Architect | System Design, DESIGN.md, ADR, Modular Contracts | Never implements production code or deploys |
-| `ui_design` | UI/UX Interface Designer | Layouts, Theme Tokens (`--dsw-alias-*`), Slots | Never writes backend Cordis services |
-| `frontend` | Frontend Developer | React Components, Client Hooks, DOM Events | Never alters backend routes or DB schemas |
-| `backend` | Backend Developer | Cordis Services, WebServer Routes, Data Store | Never writes client React JSX or styles |
-| `fullstack` | Fullstack Integrator | Client-Server Contract Wiring, End-to-End Flow | Adheres strictly to modular limits |
-| `qa_tests` | QA Automation Specialist | Unit Tests (`node:test`), Boundary Verification | Verifies without external network calls |
-| `bugfix` | Hotfix & Triage Engineer | Root-Cause Diagnosis, Minimal Blast Radius Fixes | Never refactors unrelated code |
-| `docs` | Documentation Specialist | Trilingual Documentation (en/ru/zh), Releases | Never overwrites previous documentation |
-| `refactoring` | Refactoring Specialist | Complexity Reduction (YAGNI), Bundle Compression | Preserves backwards compatibility |
-| `research` | Research & Spike Engineer | Technology Evaluation, Library Trade-Offs | Delivers analysis; never merges spike code |
-| `devops` | DevOps & Tooling Engineer | Package Manifests, Build Verification, Systemd | Never exposes private network credentials |
----
-## 🔄 Complexity Scenarios
-1. **Hotfix / Trivial (1 Stage)**: Instant defect elimination or single-parameter tweak.
-2. **Simple (2 Stages)**: Discussion & Spec $\rightarrow$ Targeted Execution.
-3. **Medium (3–4 Stages)**: Spec $\rightarrow$ UI Design $\rightarrow$ Frontend Code $\rightarrow$ QA Tests.
-4. **Complex (5–6 Stages)**: Spec $\rightarrow$ Architecture $\rightarrow$ UI Design $\rightarrow$ Implementation $\rightarrow$ QA $\rightarrow$ Trilingual Docs.
-5. **Enterprise / Deep R&D (7 Stages)**: Spike Research $\rightarrow$ Spec $\rightarrow$ Architecture $\rightarrow$ Parallel Backend & UI Design $\rightarrow$ Frontend Assembly $\rightarrow$ Comprehensive QA $\rightarrow$ Documentation Gate.
-6. **Custom DAG Scenarios**: Fully configurable in plugin settings with custom stages and blocker checkboxes.
----
-## ⚡ Prompt Caching Mechanics
-Modern LLMs (DeepSeek-V3, Claude 3.5 Sonnet, vLLM) cache prompt KV states strictly from the first token forward. If non-deterministic timestamps or random IDs are placed in the prompt header, cache hit rate drops to 0%.
-`dsh-agent-orchestrator` enforces a **4-layer canonical layout**:
-1. **Layer 1: Static Base Anchor (>1024 tokens)**: Byte-identical guidelines and tools definition common across all agents.
-2. **Layer 2: Shared Task Anchor**: Stable description of user objective and target repository.
-3. **Layer 3: Cumulative Context (Append-Only)**: Outputs of predecessor stages appended in a deterministic sequence, preserving 100% of the preceding KV-cache.
-4. **Layer 4: Role Directive (Suffix)**: Role persona prompt, skills, and subtask-specific scope appended at the end.
-This architecture delivers **80–95% cache hits** across subagents utilizing the same model, reducing TTFT and cutting token costs by ~90%.
----
-## 💻 Usage
-### 1. In DSH Chat via Slash Command
-```text
-/orchestrate Design and build a settings card for the finance plugin
-```
-Explicit scenario selection:
-```text
-/orchestrate complex Build a multi-tenant authentication provider
-/orchestrate hotfix Fix null reference in store.js
-```
-Short alias:
-```text
-/orc Refactor state management
-```
-### 2. In @goodandready/dsh-kanban
-- Open any card on the board.
-- Click **[Собрать пайплайн / Assemble Pipeline]**.
-- Select the complexity preset or allow auto-triage.
-- The card automatically reflects stage transitions and advances to `Review` upon completion.
----
-## 🧪 Verification & Automated Testing
-Execute the native test suite (121 passing tests across 53 suites, zero network dependencies):
-```bash
-node --test test/*.test.mjs
-```
-Verify npm package bundle size compliance (<256 KiB threshold):
+> **This plugin is no longer maintained.** Multi-agent orchestration is built into
+> DeepSeek Harness since **0.1.5**. Remove the plugin and use the built-in tools below.
 ```bash
-npm pack --dry-run --json
+dsh plugin --profile web remove @goodandready/dsh-agent-orchestrator
 ```
----
-## Visual verification
+## What to use instead
-Production acceptance of v0.1.6 — Settings card, Dark and Light themes side by side:
+| The plugin gave you | Built into DeepSeek Harness |
+|---|---|
+| Task decomposition, DAG pipelines, worker pool | the `workflow` tool — a JavaScript orchestration script that runs subagents in the sandbox, with run progress shown in the conversation |
+| Specialized roles (spec, backend, QA, docs…) | the `subagent` tool with `agentPreset` — any agent preset, including your own |
+| "Keep going until it is done" loops | the `ralph` tool — a loop of fresh agents over the workflow and subagent seams |
+| Agent teams, shared task board, agent mailbox | Agent Teams (experimental, DeepSeek Harness 0.1.7) |
+| `/orchestrate`, `/orc`, `agent_run` | ask the agent to use `workflow` or `subagent` |
-![dsh-agent-orchestrator v0.1.6 visual verification](media/visual-verification.png)
+## Data
----
+The plugin kept its state in `~/.dsh/orchestrator-pipelines.json` and
+`~/.dsh/orchestrator-snapshots/`. After removing the plugin these files are no longer read
+and can be deleted.
-## 📄 License
+## History
-MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)
+The last functional release is **0.1.12**. Version **0.1.13** only carries this notice;
+the code is unchanged. See [CHANGELOG.md](CHANGELOG.md).
+License: MIT.

package/README.ru.md CHANGED Viewed

@@ -1,183 +1,30 @@
-# 📦 @goodandready/dsh-agent-orchestrator
+# dsh-agent-orchestrator — плагин устарел
-<div align="center">
-<h3>Мульти-агентная декомпозиция задач, DAG-оркестрация и оптимизатор Prompt Caching для DeepSeek Harness</h3>
-<p align="center">
-  <a href="https://www.npmjs.com/package/@goodandready/dsh-agent-orchestrator"><img src="https://img.shields.io/npm/v/@goodandready/dsh-agent-orchestrator.svg?style=for-the-badge&color=6366f1&labelColor=1e1b4b" alt="npm version"></a>
-  <a href="LICENSE"><img src="https://img.shields.io/github/license/GooDAnDReaDY/dsh-agent-orchestrator.svg?style=for-the-badge&color=10b981&labelColor=064e3b" alt="license"></a>
-  <a href="https://github.com/topics/dsh-plugin"><img src="https://img.shields.io/badge/DSH-Plugin-8b5cf6.svg?style=for-the-badge&labelColor=2e1065" alt="DSH Plugin"></a>
-  <a href="https://nodejs.org"><img src="https://img.shields.io/badge/Node-20%2B-f59e0b.svg?style=for-the-badge&labelColor=451a03" alt="Node version"></a>
-</p>
-<p align="center">
-  <a href="https://goodandready.app/"><img src="https://img.shields.io/badge/Все_проекты_автора-goodandready.app-ff4500.svg?style=for-the-badge&logo=rocket&logoColor=white&labelColor=1a1a2e" alt="Все проекты автора"></a>
-</p>
-<p align="center">
-  <a href="README.md"><b>🇬🇧 English</b></a> •
-  <a href="README.ru.md"><b>🇷🇺 Русский</b></a> •
-  <a href="README.zh.md"><b>🇨🇳 中文说明</b></a>
-</p>
-<table align="center">
-  <tr>
-    <td align="center">
-      ⭐ <strong>Если вам понравился этот плагин, поставьте звезду на GitHub</strong> — это показывает востребованность разработки и мотивирует развивать проект дальше.
-      <br><br>
-      🐛 <strong>Если вы нашли ошибку или хотите предложить улучшение</strong>, откройте issue на GitHub на любом удобном языке — предложения рассматриваются для будущих версий.
-    </td>
-  </tr>
-</table>
-</div>
----
-## ⚡ Обзор и решаемая проблема
-При выполнении комплексных многоэтапных проектов один агент неизбежно сталкивается с перегрузкой контекста: в один монолитный запрос смешиваются архитектура, дизайн, верстка, бэкенд, тестирование и написание документации. Это приводит к галлюцинациям, нарушению контрактов и неоправданным затратам токенов.
-Кроме того, запуск независимых субагентов обычно сбрасывает KV-кэш языковой модели на каждом шаге, теряя преимущества префиксного кэширования (Prompt Caching) и приводя к долгим задержкам ответа.
-**`@goodandready/dsh-agent-orchestrator`** внедряет автономную мульти-агентную оркестрацию в DeepSeek Harness:
-1. **Триаж и декомпозиция**: Анализирует задачу из чата или карточки Канбана и разбивает её на этапы между **12 специализированными ролями агентов**.
-2. **Графовый DAG-движок**: Планирует задачи на основе направленного ациклического графа, исполняя независимые ветки параллельно и контролируя блокеры.
-3. **Оптимизатор Prompt Caching (KV-кэш)**: Гарантирует побайтовое совпадение префикса для агентов с одинаковыми моделями, обеспечивая 80–90% Cache Hit и моментальный старт генерации.
-4. **Строгое разделение труда**: Бэкенд, UI-дизайн и клиентский фронтенд строго изолированы по разным ролям и этапам.
-5. **Два режима работы**: Через команду `/orchestrate` в чате DSH (с плавающей карточкой прогресса в шапке) или через доску задач `@goodandready/dsh-kanban`.
----
-## 🏗️ Архитектура
-```mermaid
-graph TD
-    Trigger["Входная задача<br/>(/orchestrate в чате или карточка Канбана)"] --> Main["Главный оркестратор (Триаж)"]
-    subgraph Engine ["Движок DAG и Prompt Caching"]
-        L1["Уровень 1: Канонический базовый якорь (>1024 токенов)"]
-        L2["Уровень 2: Общий якорь задачи"]
-        L3["Уровень 3: Накопленные артефакты (Append-Only)"]
-        L4["Уровень 4: Суффиксная директива роли"]
-    end
-    Main --> Engine
-    subgraph AgentPool ["Настроенные персоны агентов (Автономно в настройках)"]
-        R1["ТЗ-аналитик"]
-        R2["Системный архитектор"]
-        R3["UI/UX Дизайнер"]
-        R4["Бэкенд-разработчик"]
-        R5["Фронтенд-разработчик"]
-        R6["QA Automation инженер"]
-        R7["Технический писатель"]
-    end
-    Engine --> AgentPool
-    AgentPool --> Delivery["Поставка результата<br/>(Карточка в шапке и синхронизация с Канбаном)"]
-```
----
-## 👥 12 встроенных специализированных ролей агентов
-Все профили агентов **хранятся и настраиваются исключительно внутри настроек плагина** (без внешних файлов):
-| Код роли | Название | Специализация | Жёсткие границы |
-|---|---|---|---|
-| `spec` | ТЗ-аналитик | Требования, критерии приёмки (DoD), структуры данных | Не пишет код реализации и стили |
-| `architecture` | Системный архитектор | Системный дизайн, DESIGN.md, ADR, модульные контракты | Не реализует прод-код и не деплоит |
-| `ui_design` | UI/UX Дизайнер | Макеты, токены темы (`--dsw-alias-*`), слоты | Не пишет серверные сервисы Cordis |
-| `frontend` | Фронтенд-разработчик | React-компоненты, хуки клиента, DOM-события | Не меняет бэкенд-роуты и схемы БД |
-| `backend` | Бэкенд-разработчик | Сервисы Cordis, WebServer-роуты, хранилище | Не пишет клиентский React JSX и CSS |
-| `fullstack` | Фуллстек-интегратор | Связка клиент-серверного контракта, сквозной поток | Строго следует границам модулей |
-| `qa_tests` | QA Automation инженер | Модульные тесты (`node:test`), проверка границ | Тестирует без внешних сетевых вызовов |
-| `bugfix` | Hotfix-инженер | Поиск первопричины, минимальный точечный фикс | Не рефакторит несвязанный код |
-| `docs` | Технический писатель | Трёхъязычная документация (en/ru/zh), релизы | Не перезаписывает прежнюю документацию |
-| `refactoring` | Рефакторинг-специалист | Устранение оверинжиниринга (YAGNI), сжатие бандла | Сохраняет обратную совместимость |
-| `research` | Исследователь (Spike) | Сравнение библиотек, архитектурные пробы | Готовит отчёт, не мержит спайк-код |
-| `devops` | DevOps-инженер | Манифесты пакетов, валидация сборки, systemd | Не раскрывает приватные учетные данные |
----
-## 🔄 Сценарии сложности
-1. **Hotfix / Минорный (1 этап)**: Точечное устранение дефекта или правка одного параметра.
-2. **Простой (2 этапа)**: Обсуждение и ТЗ $
-3. **Средний (3–4 этапа)**: ТЗ $
-4. **Комплексный (5–6 этапов)**: ТЗ $
-5. **Корпоративный / Enterprise (7 этапов)**: Исследовательский спайк $
-6. **Пользовательские DAG-сценарии**: Полностью настраиваются в параметрах плагина с произвольными этапами и чекбоксами блокировок.
----
-## ⚡ Механика Prompt Caching
-Современные LLM кэшируют KV-состояния строго от первого токена вперёд. Случайные временные метки или ID в шапке промпта сбрасывают Cache Hit до 0%.
-`dsh-agent-orchestrator` обеспечивает **4-слойную каноническую структуру**:
-1. **Уровень 1: Статический базовый якорь (>1024 токенов)**: Побайтово идентичные правила и инструменты, общие для всех агентов.
-2. **Уровень 2: Общий якорь задачи**: Стабильное описание цели пользователя и целевого репозитория.
-3. **Уровень 3: Накопленный контекст (Append-Only)**: Результаты предыдущих этапов дописываются строго в конец, сохраняя 100% предыдущего KV-кэша.
-4. **Уровень 4: Директива роли (Суффикс)**: Промпт роли, специализированные инструкции и локальный скоуп этапа.
-Такая архитектура даёт **80–95% попаданий в кэш** между субагентами на одной модели, снижая TTFT и сокращая затраты на токены на ~90%.
----
-## 💻 Использование
-### 1. В чате DSH через слэш-команду
-```text
-/orchestrate Спроектируй и разработай карточку настроек для плагина финансов
-```
-Явный выбор сценария сложности:
-```text
-/orchestrate complex Разработай провайдер мультитенантной аутентификации
-/orchestrate hotfix Исправь обращение к null в store.js
-```
-Короткий алиас:
-```text
-/orc Рефакторинг управления состоянием
-```
-### 2. В @goodandready/dsh-kanban
-- Открой любую карточку задачи на доске.
-- Нажми **[Собрать пайплайн]**.
-- Выбери пресет сложности или оставь авто-триаж.
-- Карточка отображает переходы между этапами и автоматически переводится в `Review` по готовности.
----
-## 🧪 Верификация и тестирование
-Запуск нативного набора тестов (121 тест без внешних сетевых зависимостей):
-```bash
-node --test test/*.test.mjs
-```
-Проверка размера бандла перед публикацией (<256 КБ):
+> **Плагин больше не развивается.** Оркестрация нескольких агентов встроена в
+> DeepSeek Harness начиная с **0.1.5**. Удалите плагин и используйте встроенные инструменты.
 ```bash
-npm pack --dry-run --json
+dsh plugin --profile web remove @goodandready/dsh-agent-orchestrator
 ```
----
+## Чем заменить
-## 🖼️ Визуальная верификация
+| Что давал плагин | Что есть в DeepSeek Harness |
+|---|---|
+| Декомпозиция задач, DAG-конвейеры, пул воркеров | инструмент `workflow` — JavaScript-сценарий, который запускает субагентов в песочнице; ход выполнения виден в разговоре |
+| Специализированные роли (spec, backend, QA, docs…) | инструмент `subagent` с параметром `agentPreset` — любой пресет агента, в том числе собственный |
+| Циклы «работать, пока не готово» | инструмент `ralph` — цикл свежих агентов поверх `workflow` и субагентов |
+| Команды агентов, общая доска задач, почта агентов | Agent Teams (экспериментально, DeepSeek Harness 0.1.7) |
+| `/orchestrate`, `/orc`, `agent_run` | попросите агента использовать `workflow` или `subagent` |
-Приёмка v0.1.6 в окружении DSH — карточка настроек, темная и светлая темы:
+## Данные
-![dsh-agent-orchestrator v0.1.6 visual verification](media/visual-verification.png)
+Плагин хранил состояние в `~/.dsh/orchestrator-pipelines.json` и
+`~/.dsh/orchestrator-snapshots/`. После удаления плагина они больше не читаются, их можно удалить.
----
+## История
-## 📄 Лицензия
+Последний рабочий выпуск — **0.1.12**. Версия **0.1.13** содержит только это
+уведомление, код не менялся. См. [CHANGELOG.md](CHANGELOG.md).
-MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)
+Лицензия: MIT.

package/README.zh.md CHANGED Viewed

@@ -1,183 +1,29 @@
-# 📦 @goodandready/dsh-agent-orchestrator
+# dsh-agent-orchestrator — 已弃用
-<div align="center">
-<h3>面向 DeepSeek Harness 的多智能体任务分解、DAG 工作流编排与提示词缓存优化引擎</h3>
-<p align="center">
-  <a href="https://www.npmjs.com/package/@goodandready/dsh-agent-orchestrator"><img src="https://img.shields.io/npm/v/@goodandready/dsh-agent-orchestrator.svg?style=for-the-badge&color=6366f1&labelColor=1e1b4b" alt="npm version"></a>
-  <a href="LICENSE"><img src="https://img.shields.io/github/license/GooDAnDReaDY/dsh-agent-orchestrator.svg?style=for-the-badge&color=10b981&labelColor=064e3b" alt="license"></a>
-  <a href="https://github.com/topics/dsh-plugin"><img src="https://img.shields.io/badge/DSH-Plugin-8b5cf6.svg?style=for-the-badge&labelColor=2e1065" alt="DSH Plugin"></a>
-  <a href="https://nodejs.org"><img src="https://img.shields.io/badge/Node-20%2B-f59e0b.svg?style=for-the-badge&labelColor=451a03" alt="Node version"></a>
-</p>
-<p align="center">
-  <a href="https://goodandready.app/"><img src="https://img.shields.io/badge/作者所有项目-goodandready.app-ff4500.svg?style=for-the-badge&logo=rocket&logoColor=white&labelColor=1a1a2e" alt="作者所有项目"></a>
-</p>
-<p align="center">
-  <a href="README.md"><b>🇬🇧 English</b></a> •
-  <a href="README.ru.md"><b>🇷🇺 Русский</b></a> •
-  <a href="README.zh.md"><b>🇨🇳 中文说明</b></a>
-</p>
-<table align="center">
-  <tr>
-    <td align="center">
-      ⭐ <strong>如果您喜欢此插件，请在 GitHub 上点亮 Star</strong> — 这是对我持续投入开发的最大鼓励。
-      <br><br>
-      🐛 <strong>若发现 Bug 或有功能建议</strong>，欢迎随时在 GitHub 提交 Issue（支持任意语言）— 我将在后续版本中积极评估并实现。
-    </td>
-  </tr>
-</table>
-</div>
----
-## ⚡ 概述与解决的核心痛点
-在执行复杂的多阶段工程任务时，单一智能体架构往往面临认知过载：在单一上下文请求中混合了系统架构、界面布局、前端交互、服务端逻辑、单元测试与文档编写，极易导致接口幻觉、功能退化与不必要的 Token 浪费。
-此外，各子智能体的独立执行通常会中断大语言模型的 KV 缓存复用，失去前缀提示词缓存（Prompt Caching）的优势，产生严重的首次响应延迟 (TTFT) 与高昂的推理成本。
-**`@goodandready/dsh-agent-orchestrator`** 为 DeepSeek Harness 提供完整的自主多智能体编排方案：
-1. **智能分流与任务分解**：深度解析来自聊天或看板卡片的目标，拆解并分发给 **12 个专属智能体角色**。
-2. **有向无环图 (DAG) 引擎**：基于依赖拓扑结构并行调度无阻塞子任务，严格保障阻断检查点。
-3. **KV 缓存 / Prompt Caching 优化器**：确保同模型智能体之间保持字节级的前缀一致性，释放 80–90% 的缓存命中率并实现极速首字输出。
-4. **严格的权责分离**：服务端后端、UI 界面设计与客户端前端实现各自保持独立的角色与执行阶段，杜绝单一智能体跨界混写。
-5. **双场景原生集成**：支持在 DSH 聊天中通过 `/orchestrate` 斜杠命令直接调用（带顶部吸顶里程碑卡片），亦可无缝接入 `@goodandready/dsh-kanban` 看板。
----
-## 🏗️ 系统架构图
-```mermaid
-graph TD
-    Trigger["输入任务<br/>(聊天中 /orchestrate 或看板卡片)"] --> Main["主调度器 (分流与规划)"]
-    subgraph Engine ["DAG 调度引擎与提示词缓存优化"]
-        L1["第 1 层：规范化基础锚点 (>1024 Token)"]
-        L2["第 2 层：共享任务上下文锚点"]
-        L3["第 3 层：阶段累计产物 (仅追加模式)"]
-        L4["第 4 层：角色专属后缀指令"]
-    end
-    Main --> Engine
-    subgraph AgentPool ["配置化智能体角色池 (完全内聚于插件设置)"]
-        R1["需求分析师"]
-        R2["系统架构师"]
-        R3["UI/UX 设计师"]
-        R4["后端工程师"]
-        R5["前端工程师"]
-        R6["QA 自动化工程师"]
-        R7["技术文档专家"]
-    end
-    Engine --> AgentPool
-    AgentPool --> Delivery["编排交付<br/>(顶部状态卡片与看板状态同步)"]
-```
----
-## 👥 12 大内置专属智能体角色矩阵
-所有智能体预设均**完全内聚于插件设置面板中**（无需依赖本地额外配置文件）：
-| 角色 ID | 角色名称 | 核心专业领域 | 严格职责边界 |
-|---|---|---|---|
-| `spec` | 需求分析师 | 功能规范、验收准则 (DoD)、数据结构定义 | 严禁编写业务实现代码或样式 |
-| `architecture` | 系统架构师 | 架构设计、DESIGN.md、ADR 决策、模块契约 | 严禁编写生产代码或执行部署 |
-| `ui_design` | UI/UX 设计师 | 界面布局、主题变量 (`--dsw-alias-*`)、插槽设计 | 严禁编写服务端 Cordis 服务逻辑 |
-| `frontend` | 前端工程师 | React 组件、客户端 Hooks、DOM 交互与事件 | 严禁修改后端路由或数据库存储 |
-| `backend` | 后端工程师 | Cordis 服务、WebServer 路由、状态与持久化 | 严禁编写客户端 React JSX 或前端 CSS |
-| `fullstack` | 全栈集成师 | 端到端契约对接、全链路串联打通 | 严格遵守模块化边界规范 |
-| `qa_tests` | QA 自动化工程师 | 原生单元测试 (`node:test`)、边界用例覆盖 | 仅限无外网依赖的纯净验证 |
-| `bugfix` | 缺陷修复专家 | 根因精准定位、最小爆炸半径修复 | 严禁重构无关代码 |
-| `docs` | 技术文档专家 | 英中俄三语文档编撰 (en/ru/zh)、发行注记 | 严禁覆盖或删除旧版有效文档 |
-| `refactoring` | 重构精简专家 | 复杂度裁剪 (YAGNI)、代码瘦身与体积压缩 | 必须严格保持向前兼容 |
-| `research` | 前沿探索工程师 | 技术选型评估、多方案 Spike 对比验证 | 输出分析报告，严禁直接合并 Spike 代码 |
-| `devops` | 运维与工具工程师 | 包清单规范化、打包构建校验、systemd 守护 | 严禁泄露内部网络凭证与私钥 |
----
-## 🔄 复杂度编排场景
-1. **Hotfix / 紧急缺陷 (1 阶段)**：即时消除单一 Bug 或调整单项配置参数。
-2. **Simple / 简易任务 (2 阶段)**：方案讨论与规范 $
-3. **Medium / 中型需求 (3–4 阶段)**：需求分析 $
-4. **Complex / 复杂项目 (5–6 阶段)**：需求分析 $
-5. **Enterprise / 深度研发 (7 阶段)**：技术评估 Spike $
-6. **自定义 DAG 场景**：在插件设置面板自由增删阶段、配置依赖关系与阻断检查点。
----
-## ⚡ 提示词缓存 (Prompt Caching) 底层原理
-主流大语言模型严格从第一个 Token 开始构建并复用 KV 缓存。如果在 Prompt 开头混入不确定性的时间戳或随机 ID，缓存命中率将骤降至 0%。
-`dsh-agent-orchestrator` 强制采用 **4 层规范化布局**：
-1. **第 1 层：静态基础锚点 (>1024 Token)**：所有智能体共享的字节级完全一致的规则与工具说明。
-2. **第 2 层：共享任务上下文锚点**：用户核心目标与目标仓库的稳定描述。
-3. **第 3 层：阶段累计产物 (仅追加模式)**：前序阶段产物按确定性顺序追加，完全保留前置 KV 缓存。
-4. **第 4 层：角色专属后缀指令**：智能体角色人设、技能指导与当前子任务专属指令置于最末端。
-此架构能够使共享同一模型的子智能体达到 **80–95% 的缓存命中率**，极大降低首字生成延迟并将 Token 消耗降低约 90%。
----
-## 💻 使用指南
-### 1. 在 DSH 聊天中通过斜杠命令触发
-```text
-/orchestrate 为财务管理插件设计并开发设置卡片
-```
-显式指定复杂度预设：
-```text
-/orchestrate complex 构建多租户身份认证提供商服务
-/orchestrate hotfix 修复 store.js 中的空指针异常
-```
-简明别名：
-```text
-/orc 重构状态管理模块
-```
-### 2. 在 @goodandready/dsh-kanban 看板中协作
-- 打开看板上的任意任务卡片。
-- 点击 **[Собрать пайплайн / 装配工作流]**。
-- 选择复杂度预设或采用自动分流。
-- 任务卡片实时展示各阶段进度，任务完成自动推进至 `Review` 状态。
----
-## 🧪 自动化测试与打包验证
-执行原生测试套件（121 个用例全部通过，零外部网络依赖）：
-```bash
-node --test test/*.test.mjs
-```
-验证 npm 打包体积合规性（严格低于 256 KiB 上限）：
+> **本插件已停止维护。** 自 **0.1.5** 起，多智能体编排已内置于 DeepSeek Harness。
+> 请卸载本插件并改用下列内置工具。
 ```bash
-npm pack --dry-run --json
+dsh plugin --profile web remove @goodandready/dsh-agent-orchestrator
 ```
----
+## 替代方案
-## 🖼️ 视觉设计验收效果
+| 插件原有功能 | DeepSeek Harness 内置 |
+|---|---|
+| 任务拆解、DAG 流水线、工作池 | `workflow` 工具 — 在沙箱中运行子智能体的 JavaScript 编排脚本，运行进度显示在对话中 |
+| 专业角色（spec、backend、QA、docs…） | 带 `agentPreset` 参数的 `subagent` 工具 — 可使用任意智能体预设，包括自定义预设 |
+| “持续执行直到完成”循环 | `ralph` 工具 — 基于 workflow 与子智能体的全新智能体循环 |
+| 智能体团队、共享任务看板、智能体信箱 | Agent Teams（实验性，DeepSeek Harness 0.1.7） |
+| `/orchestrate`、`/orc`、`agent_run` | 让智能体使用 `workflow` 或 `subagent` |
-v0.1.6 生产环境验收效果 — 设置面板暗色与亮色主题对照：
+## 数据
-![dsh-agent-orchestrator v0.1.6 visual verification](media/visual-verification.png)
+插件的状态保存在 `~/.dsh/orchestrator-pipelines.json` 与 `~/.dsh/orchestrator-snapshots/`。
+卸载插件后这些文件不再被读取，可以删除。
----
+## 历史
-## 📄 开源协议
+最后一个功能版本为 **0.1.12**。**0.1.13** 仅包含本说明，代码未改动。参见 [CHANGELOG.md](CHANGELOG.md)。
-MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)
+许可证：MIT。

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "@goodandready/dsh-agent-orchestrator",
-  "version": "0.1.12",
-  "description": "Multi-agent task decomposition, DAG workflow orchestration, and prompt caching optimizer for DeepSeek Harness.",
+  "version": "0.1.13",
+  "description": "Deprecated: orchestration is built into DeepSeek Harness since 0.1.5 - use the built-in workflow tool, subagent with agentPreset, ralph and agent teams.",
   "type": "module",
   "main": "./lib/index.js",
   "exports": {
@@ -29,7 +29,8 @@
     "multi-agent",
     "prompt-caching",
     "dag-workflow",
-    "kanban"
+    "kanban",
+    "deprecated"
   ],
   "repository": {
     "type": "git",