yourssh-roadmap

Update docs/roadmap.md diffs from git history and pubspec.yaml.

38|14|Updated May 29, 2026
One-click install
npx skills add https://github.com/YoursshLabs/yourssh --skill yourssh-roadmap
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: yourssh-roadmap
Source: https://github.com/YoursshLabs/yourssh/tree/main/.claude/skills/yourssh-roadmap
Command: npx skills add https://github.com/YoursshLabs/yourssh --skill yourssh-roadmap

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Update docs/roadmap.md efficiently by diffing against the current repo state and history, avoiding a full rewrite and ensuring alignment with shipped changes and strategic plans.

Core Features & Use Cases

  • Diff-based updates: only propose changes that reflect shipped features, version bumps, and sprint outcomes.
  • Automated metadata synchronization: updates version lines and date stamps in the roadmap to reflect reality.
  • Guided workflow: determines when to refresh, how to apply changes, and how to present diffs for review.

Quick Start

Run the roadmap refresh to update docs/roadmap.md with the latest changes

Frequently Asked Questions about yourssh-roadmap

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

FAQPage Schema
How do I update my project roadmap based on git history without rewriting the whole document?

Updating a roadmap based on git history without rewriting it uses a diff-based approach to align docs/roadmap.md with the latest codebase state. It reads git log and current version data to generate precise diffs, outputting an updated section with a timestamp.

When should I refresh my project roadmap using a diff-based workflow?

Refreshing your project roadmap using a diff-based workflow is applicable during feature ships, version bumps, sprint planning, or roadmap review requests. This ensures roadmap accuracy by reflecting shipped changes and strategic plans without starting from scratch.

Does the roadmap refresh process read version information directly from pubspec.yaml?

Yes, the roadmap refresh process reads version information directly from app/pubspec.yaml. It aligns docs/roadmap.md with the current codebase state, repository surface areas, and git history to synchronize metadata like version lines and date stamps.

What is the best way to synchronize roadmap documentation with shipped features and version bumps?

The best way to synchronize roadmap documentation with shipped features and version bumps is automated metadata synchronization. It determines when to refresh, applies changes by generating precise diffs, and presents outputs for review to reflect reality accurately.

Can I use this diff-based roadmap update for sprint planning and feature ships?

Yes, you can use this diff-based roadmap update for sprint planning and feature ships. It evaluates repository surface areas and git history to propose changes that reflect sprint outcomes, ensuring documentation alignment without a full content rewrite.

Are there limitations to updating roadmap diffs against the current codebase state?

A limitation of updating roadmap diffs against the current codebase state is that it proposes changes strictly based on git log and repository surface areas. It does not generate new strategic content from scratch, focusing only on aligning existing roadmap text with shipped code reality.