roadmap-skill 0.2.10 → 0.3.0

package/CHANGELOG.md

@@ -5,6 +5,38 @@ 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
+- **MCP Prompts**: Added non-intrusive task hints to `open-web-ui` and `quick-capture` prompts
+- **Port Display**: Fixed NaN display when port parameter is not provided in `open-web-ui` prompt
+- **Prompt Wording**: Removed command-like phrasing that could be misidentified as injection attempts
+
+
 ## [0.2.10] - 2026-02-27
 
 ### Added

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.
@@ -290,28 +343,25 @@ Solo developers, AI power users, and vibe coders who want their Agent to be a re
 
 ### 1. Capture Ideas Without Breaking Flow
 
-Mid-session, something comes to mind:
+Mid-session, something pops into your head:
 
 > "Note this down: switch the auth module to JWT + refresh token rotation"
 
-Your Agent creates the task. You stay in flow. Open the Kanban later to review.
-
-### 2. Let AI Bootstrap Your Project Plan
-
-Starting something new:
+Use `/quick-capture` or just say "help me note this down" — your Agent turns it into a task, saves it locally, and you keep going. No context switch, no forgotten ideas.
 
-> "Set up a project for the admin dashboard — product management, orders, and user permissions. Break each into tasks."
+### 2. Let Agent Help You Prioritize
 
-Agent scaffolds the whole structure. You open the board and start dragging.
+> "This month's OKR is finishing the user system refactor — can you list the related tasks and figure out which ones should come first?"
 
-### 3. Check In Without Leaving the Chat
+Use `/auto-prioritize` to let your Agent analyze the current project state and reorder task priorities accordingly.
 
-> "What's left on the current project? Anything high priority I haven't touched?"
+### 3. Let Agent Recommend What to Do Next
 
-> "Mark the login feature done and add a task for writing tests."
+> "What's left on the current project? Any high-priority tasks I haven't touched yet?"
 
-No tab switching. No copy-pasting. Just ask.
+Or use `/suggest-tasks` — your Agent recommends the next actions based on current progress and priorities.
 
+No tab switching. No copy-pasting. Just ask
 ---
 
 ## Core Features
@@ -319,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 |
@@ -328,10 +382,8 @@ No tab switching. No copy-pasting. Just ask.
 
 ## Supported Platforms
 
-- ✅ **Claude Code** — Command-line AI assistant
-- ✅ **Claude Desktop** — Full MCP integration
-- ✅ **Cursor** — AI-powered IDE
-- ✅ **VS Code** — Via Cline or Roo Code extensions
+- ✅ **Claude Code, Codex, OpenCode** — Command-line AI assistants
+- ✅ **Cursor, VS Code** — AI-powered IDEs
 - ✅ **Any MCP Client** — Standard MCP protocol support
 
 ---
@@ -342,24 +394,11 @@ Roadmap Skill uses **pure local JSON file storage**. All data is saved in your u
 
 | Platform | Storage Path |
 |---------|-------------|
-| macOS | `~/.roadmap-skill/data/` |
-| Linux | `~/.roadmap-skill/data/` |
-| Windows | `%USERPROFILE%\.roadmap-skill\data\` |
-
-### Data File Structure
-
-```
-.roadmap-skill/
-└── data/
-    ├── projects.json      # Project list
-    ├── tasks.json         # All tasks
-    └── tags.json          # Tag definitions
-```
+| Windows | `%USERPROFILE%\.roadmap-skill` |
+| macOS | `~/.roadmap-skill/` |
+| Linux | `~/.roadmap-skill/` |
 
-- ✅ **Fully offline** — No internet connection needed
-- ✅ **Portable** — Copy folder to backup/transfer
-- ✅ **Version control friendly** — JSON format for easy diff
-- ✅ **Privacy secure** — Data never leaves your machine
+You can export or import backup files from the web interface.
 
 ---
 

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 真正参与项目协作，而不只是写代码的人。
@@ -285,25 +307,23 @@ AI 会立即为你创建项目和任务，并自动写入本地存储。你可
 
 ### 1. 不打断流地记录想法
 
-编着编着突然想到一个优化点：
+VibeCoding时，突然想到一个新idea/有新Bug：
 
 > "记一下：把认证模块改成 JWT + refresh token 方案"
 
-Agent 创建任务。你继续写代码。稍后打开看板再回顾。
-
-### 2. 让 AI 帮你搭建项目结构
+直接使用 `/quick-capture` 命令，或者直接说“帮我记一下”，Agent 就会把这个想法变成一个项目的代办，保存在本地，然后继续工作。等有空了再回来看，任务已经在那里了，不用担心忘记，也不用打断当前的思路去切换工具。
 
-开始一个新项目：
+### 2. 让 Agent 帮你划分任务优先级
 
-> "创建一个电商后台项目，包含商品管理、订单处理、用户权限三个模块，每个模块拆分为具体任务"
+> "这个月的 OKR 是完成用户系统重构，能不能帮我把相关的任务都列出来，并且分析一下哪些任务应该有限做？"
 
-Agent 直接搭好整个结构。你打开看板开始拖拽。
+直接使用 `/auto-prioritize` 命令，让 Agent 根据当前的项目状态，给已有的任务合理调整优先级。
 
-### 3. 不离开对话窗口就能检查进度
+### 3. 让 Agent 自动给你推荐接下来做什么
 
 > "当前项目还剩什么？有没有高优先级的任务还没动？"
 
-> "把登录功能标为已完成，再加一个写测试的任务"
+或者直接使用 `/suggest-tasks` 命令，让 Agent 根据当前进度和优先级给你推荐下一步行动。
 
 不用切换标签页，不用复制粘贴。直接问就行。
 
@@ -335,24 +355,17 @@ Roadmap Skill 采用**纯本地 JSON 文件存储**，所有数据保存在你
 
 | 平台 | 存储路径 |
 |------|---------|
-| macOS | `~/.roadmap-skill/data/` |
-| Linux | `~/.roadmap-skill/data/` |
-| Windows | `%USERPROFILE%\.roadmap-skill\data\` |
+| Windows | `%USERPROFILE%\.roadmap-skill` |
+| macOS | `~/.roadmap-skill/` |
+| Linux | `~/.roadmap-skill/` |
 
-### 数据文件结构
+你可以在前端界面中选择导出/导入备份文件。
 
-```
-.roadmap-skill/
-└── data/
-    ├── projects.json      # 项目列表
-    ├── tasks.json         # 所有任务
-    └── tags.json          # 标签定义
-```
+---
 
-- ✅ **完全离线可用** — 无需网络连接
-- ✅ **数据可迁移** — 直接复制文件夹即可备份
-- ✅ **版本控制友好** — JSON 格式便于 diff 查看变更
-- ✅ **隐私安全** — 数据永远不会离开你的电脑
+## 参与贡献
+欢迎任何形式的贡献！无论是 Bug 反馈、功能建议还是 Pull Request，都可以直接在 [GitHub](https://github.com/shiquda/roadmap-skill) 上提 Issue 或 PR。
+如果你想添加新功能，建议先开 Issue 讨论一下方向。
 
 ---