roadmap-skill 0.2.11 → 0.3.0

package/CHANGELOG.md

@@ -5,6 +5,30 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.0] - 2026-03-14
+
+### Added
+- **Graph View**: Added a full dependency graph workspace powered by React Flow for sequencing work, visualizing blockers, and reviewing execution order
+- **Dependency Editing**: Added atomic dependency edge updates, inline dependency actions, and richer graph-side editing flows
+- **Graph Export**: Added image export support for dependency views in the web workspace
+- **Workspace Metadata**: Added repository and version metadata for the web workspace header and API responses
+- **Agent Tooling**: Added agent-friendly dependency view read models, mutation change metadata, and dedicated dependency view tool coverage
+- **Planning Skills**: Added the initial roadmap skill pack for roadmap routing, task flow, planning views, and web visualization guidance
+
+### Changed
+- **Dependency Planning UX**: Improved dependency view layout, controls, inline actions, ready/done presentation, and detailed task rendering
+- **Workspace State**: Improved dependency view selection, persisted workspace state, graph layout stability, and general interaction polish
+- **Graph Layout Engine**: Bundled `elkjs` support for graph layout improvements in the web client
+- **Task Creation Flow**: Added an active-only status filter to the Add Tasks modal so large graphs are easier to extend
+- **Prompt Behavior**: Normalized optional argument handling in project prompts to reduce branching friction for Agents
+- **Documentation**: Expanded README messaging around Graph View, refreshed screenshots, and added Chinese README updates for the new planning experience
+
+### Fixed
+- **Mutation Responses**: Stabilized dependency view mutation responses and moved dependency change metadata generation into the service layer
+- **Graph Persistence**: Fixed dependency view persistence and layout stability across workspace sessions
+- **Metadata Detection**: Improved fallback behavior for app metadata resolution in the web server
+- **Repository Cleanup**: Removed temporary root screenshots from the repository
+
 ## [0.2.11] - 2026-03-09
 
 ### Fixed

package/README.md

@@ -1,12 +1,16 @@
 # Roadmap Skill
 
 <p align="center">
-  <img src="./imgs/roadmap-skill-web.png" alt="Roadmap Skill Kanban Board" width="900">
+  <img src="./imgs/roadmap-skill-web.png" alt="Roadmap Skill web workspace with kanban and graph views" width="900">
+</p>
+
+<p align="center">
+  <sub>The local planning workspace: status in Kanban, execution order in Graph View.</sub>
 </p>
 
 <p align="center">
   <strong>Shared roadmap for humans and AI Agents</strong><br>
-  Visual kanban for you. MCP server for Agents. Local-first.
+  Visual kanban and graph views for you. MCP server for Agents. Local-first.
 </p>
 
 <p align="center">
@@ -32,12 +36,39 @@
 
 **Agent-native** — Built as an MCP server. Your AI can create, update, and query tasks directly in conversation.
 
-**Lightweight Kanban** — Open `localhost:7860` when you feel like it, or ask your Agent to open it with `open_web_interface`. Or just stay in chat. All three work.
+**Visual workspace** — Open `localhost:7860` when you feel like it, or ask your Agent to open it with `open_web_interface`. Kanban for status, Graph View for sequencing. Or just stay in chat. All three work.
 
 **Local-first** — Your data lives on your machine. No accounts, no cloud sync, no vendor lock-in.
 
 ---
 
+## New in v0.3.0: Graph View
+
+Graph View is one of the headline features in `v0.3.0`.
+
+<p align="center">
+  <img src="./imgs/roadmap-graph.png" alt="Roadmap Skill graph view for dependency planning" width="900">
+</p>
+
+<p align="center">
+  <sub>Graph View turns roadmap tasks into a dependency map, so you can inspect order, blockers, and ready work at a glance.</sub>
+</p>
+
+Kanban is great for tracking status. Graph View is for understanding execution order.
+
+It helps you and your Agent answer questions like:
+
+- What has to happen first?
+- Which tasks are ready right now?
+- What is blocked by unfinished work?
+- Which dependency should be added, reversed, or removed?
+
+Instead of treating roadmap tasks as a flat list, Graph View turns them into a visual dependency map with node connections, ready/done states, detailed task cards, and export support. It is designed for planning sessions where sequencing matters just as much as status.
+
+If you are using Roadmap Skill as an MCP workspace, this is the view that makes agent-assisted planning feel concrete: your Agent can build and update dependency graphs in chat, and you can immediately inspect the structure visually in the web UI.
+
+---
+
 ## Quick Start (Zero Config)
 
 ```bash
@@ -280,6 +311,28 @@ The AI will immediately create the project and tasks, saving them to local stora
 
 ---
 
+## Agent Skills
+
+This repository includes installable skills under `skills/`, distributed through the git repository rather than the published npm package.
+
+Available skills:
+
+- `skills/roadmap/` - lightweight background and routing for roadmap-skill
+- `skills/roadmap-task-flow/` - capture, enrich, tag, and prioritize roadmap tasks
+- `skills/roadmap-planning-views/` - build focused planning graphs from task subsets
+- `skills/roadmap-web-visualization/` - open and use the local roadmap web workspace
+
+Recommended installation pattern for skill-aware tools:
+
+```bash
+# install from the git repository when the installer supports repo sources
+npx skills add shiquda/roadmap-skill
+```
+
+These skills are still in beta. If you run into issues or have suggestions, feedback is very welcome.
+
+---
+
 ## Who Is This For?
 
 Solo developers, AI power users, and vibe coders who want their Agent to be a real collaborator — not just a code generator.
@@ -308,7 +361,7 @@ Use `/auto-prioritize` to let your Agent analyze the current project state and r
 
 Or use `/suggest-tasks` — your Agent recommends the next actions based on current progress and priorities.
 
-No tab switching. No copy-pasting. Just ask.
+No tab switching. No copy-pasting. Just ask
 ---
 
 ## Core Features
@@ -316,6 +369,10 @@ No tab switching. No copy-pasting. Just ask.
 | Feature | Description |
 |--------|-------------|
 | **Kanban View** | Four columns: Todo, In Progress, Review, Done |
+| **Graph View** | Visual dependency map for sequencing work, spotting blockers, and reviewing execution order |
+| **Ready / Blocked Signals** | Quickly see which tasks are ready now and which ones still depend on unfinished work |
+| **Dependency Editing** | Add, reverse, and remove task dependencies directly from the planning graph |
+| **Graph Export** | Export dependency graphs as images for sharing, review, or release planning |
 | **Drag and Drop** | Drag tasks to update status, WYSIWYG |
 | **Quick Create** | Click "+" button on any column to instantly add tasks |
 | **Dual View** | Compact mode for overview, detailed mode for full info |

package/README.zh.md

@@ -277,6 +277,28 @@ AI 会立即为你创建项目和任务，并自动写入本地存储。你可
 
 ---
 
+## Agent Skills
+
+本仓库在 `skills/` 目录下提供了一组可安装的 Agent Skills，它们通过 git 仓库分发，而不是通过已发布的 npm 包分发。
+
+可用的 Skills：
+
+- `skills/roadmap/` - 轻量背景介绍与路由入口
+- `skills/roadmap-task-flow/` - 记录、补全、整理和重排任务列表
+- `skills/roadmap-planning-views/` - 从任务子集构建聚焦的规划视图与图工作区
+- `skills/roadmap-web-visualization/` - 打开并使用本地 roadmap Web 工作区
+
+对于支持 Skill 安装的工具，推荐这样安装：
+
+```bash
+# 当安装器支持从仓库安装时，直接从 git 仓库安装
+npx skills add shiquda/roadmap-skill
+```
+
+这些 Skills 目前仍是测试版本；如果你在使用中遇到问题，或者有任何建议，欢迎反馈。
+
+---
+
 ## 适合谁使用
 
 独立开发者、AI 重度用户、Vibe Coder — 想让 Agent 真正参与项目协作，而不只是写代码的人。