harness-roadmap

Automate creation and management of a unified project roadmap from specs and plans.

18|11|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/Intense-Visions/harness-engineering --skill harness-roadmap
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: harness-roadmap
Source: https://github.com/Intense-Visions/harness-engineering/tree/main/agents/skills/claude-code/harness-roadmap
Command: npx skills add https://github.com/Intense-Visions/harness-engineering --skill harness-roadmap

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creating and maintaining a unified project roadmap from scattered specs and plans is error-prone and manual. Harness Roadmap enforces human-approved structure and keeps statuses in sync with artifacts, reducing drift and rework.

Core Features & Use Cases

  • Discover specs (docs/changes//proposal.md) and plans (docs/plans/.md) and surface a coherent roadmap structure.
  • Group features into milestones, link specs and plans, and generate a writable docs/roadmap.md using MCP or direct edits.
  • Interactive workflows for creating, updating, syncing, and querying the roadmap, with guardrails and validation.

Quick Start

Bootstraps a roadmap by discovering specs and plans, then confirm before writing docs/roadmap.md.

Frequently Asked Questions about harness-roadmap

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a unified project roadmap from scattered specs and plans?

To generate a unified project roadmap, you can discover specs and plans to group features into milestones and write a compliant docs/roadmap.md file. This process requires human confirmation before writing to ensure an authoritative structure.

How does roadmap synchronization with artifact state work?

Roadmap synchronization works by mapping plans and linking specs to keep statuses updated with artifact state. This automated tracking reduces manual drift and rework when maintaining the docs/roadmap.md file.

Can I use MCP tooling to manage project roadmaps and milestones?

Yes, you can use MCP tooling to manage project roadmaps by creating, updating, syncing, and querying milestones. It provides interactive workflows with guardrails and validation for direct markdown edits.

What is the best way to structure a docs/roadmap.md file from proposals?

The best way to structure a docs/roadmap.md file is to group features into milestones and link docs/changes/*/proposal.md files. This creates a coherent, human-approved roadmap that stays compliant with project governance.

Do I need human approval to update the project roadmap?

Yes, you need human approval to update the project roadmap because the workflow enforces human-confirmed changes. Bootstrapping the roadmap also requires explicit confirmation before writing the docs/roadmap.md file.

Why does my project roadmap drift from the actual spec and plan artifacts?

Your project roadmap drifts when manual updates fail to keep statuses in sync with artifact state. Automating the discovery of specs and plans enforces a unified structure that reduces this drift and rework.