Can it update my project documentation automatically?

Yes, the /roadmap update command scans your git history and codebase to sync status documents, providing a 'What Shipped' summary and requiring user confirmation before writing changes.

Does it support risk management?

Yes, it includes a dedicated risk register mode that categorizes potential project threats by likelihood and impact, providing a structured score and mitigation path for each.

How does the Roadmap skill track project progress?

It analyzes both the codebase structure and git history to identify completed features, pending tasks, and the maturity levels of different backend and frontend modules.

How does it handle documentation drift?

The skill checks the last modification of your status files against recent git commits; if it detects three or more feature/fix commits since the last update, it flags the documentation as potentially stale.

What is Deep Mode in the Roadmap Analyst skill?

Deep mode (--deep) triggers a multi-agent pipeline where specialized AI perspectives analyze the project in parallel to surface contradictions, architectural risks, and strategic gaps.

Roadmap Analyst

Name: Roadmap Analyst
Author: joaquimscosta

byjoaquimscosta

•

协作工具

Synthesizes project documentation and codebase state into actionable status reports, gap analyses, and development milestones.

The Roadmap Analyst skill transforms fragmented project data and source code into a cohesive strategic overview. It enables teams to automatically assess project health, identify technical debt gaps, trace blocking chains, and verify specification compliance. By integrating directly with git history and the filesystem, it provides an evidence-based 'source of truth' that compares the original project plan against the actual implementation reality, ensuring documentation never drifts from the codebase through automated drift detection and git-aware status updates.

主要功能

01Gap analysis and blocker tracing to identify critical development bottlenecks

02Git-aware status updates that summarize shipped features, PRs, and ADRs

03Automated project health dashboards with module maturity scaling

04Deep analysis mode using parallel cross-perspective synthesis from PM and Architect viewpoints

059 GitHub stars

06Risk register generation with impact scoring and mitigation strategies

使用场景

01Identifying 'documentation drift' where the codebase has evolved beyond the existing specifications

02Generating high-level status reports for stakeholders before sprint reviews or planning sessions

03Prioritizing technical debt and next actions based on unclosed gaps and module maturity

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add joaquimscosta/arkhe-claude-plugins roadmap

For use in Claude.ai and ChatGPT

Download Skill