What problem does it solve? In projects using Spec Kit (speckit) SDD artifacts, roadmaps and their underlying specs, plans, research decisions, and task lists drift out of sync with the code and the outside world, and a plain roadmap refresh cannot tell which artifact a finding belongs in. ## Core Features & Use Cases - Artifact-aware staleness detection: Runs /speckit-analyze as a free drift detector and scans for contradictions like ticked tasks whose code does not exist or requirements reachable from no task. - Finding routing: Routes each research finding to the correct destination — the roadmap, spec.md (via clarify), plan.md, research.md, tasks.md, or the constitution — instead of dumping everything into chunk descriptions. - Decision provenance: Confirms or overturns named research.md decisions by id and records which artifacts changed, so the next session can audit the refresh. - Use Case: In a speckit-initialized repo, ask to revisit the roadmap; the skill grounds in the spec and plan, researches what changed externally, and reshapes both the roadmap and the stale artifacts without implementing any code. ## Quick Start In a repository containing a .specify/ directory, ask the agent to run /roadmap-refresh-sk to research and refresh the roadmap and its Spec Kit artifacts.
