roadmap-gating

Synchronizes roadmap and checklist files with code changes during Git commits.

Updated Sep 3, 2026
One-click install
npx skills add https://github.com/CMiller838/meal-planner --skill roadmap-gating-cmiller838
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: roadmap-gating
Source: https://github.com/CMiller838/meal-planner/tree/main/.claude/skills/roadmap-gating
Command: npx skills add https://github.com/CMiller838/meal-planner --skill roadmap-gating-cmiller838

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Code changes often drift out of sync with project tracking documents, leaving roadmap.md and tasks.md files stale and misleading. This Skill enforces an automatic alignment loop so progress documentation is updated in the same commit as the code that completed it. ## Core Features & Use Cases - Dynamic File Discovery: Uses Glob and Grep to locate active checklist files (tasks.md, todo.md, checklist.md) and the single active roadmap at docs/roadmap.md, while ignoring archived versions in .claude/archive/. - Checklist and Phase Auditing: Matches edited or created code files against outstanding checkboxes, marks completed tasks as done, and evaluates whether roadmap phases or milestones are satisfied. - Atomic Progress Commits: Ensures updated tracking files are staged and committed together with the related code changes using conventional commit prefixes like feat: and fix:. - Use Case: Before committing a finished feature, run this protocol to automatically check off the corresponding tasks in tasks.md, mark the roadmap phase complete, and include both updates in the same commit. ## Quick Start Before committing my changes, discover the active roadmap and checklist files, mark completed tasks, and include those updates in the same commit.

Frequently Asked Questions about roadmap-gating

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

FAQPage Schema
How do I keep roadmap and tasks files in sync with code commits?

Run a gating protocol before staging that discovers tasks.md and docs/roadmap.md, marks completed checkboxes based on your edited files, and commits the documentation updates in the same Git commit as the code changes.

How to automatically update a project checklist when finishing tasks?

Match the files you created or edited against outstanding checkboxes in the checklist file, then mark satisfied items as checked (- [x]) while preserving the file's original formatting and history.

Does this work with multiple roadmap files in a repository?

No, it treats docs/roadmap.md as the single active roadmap. Superseded versions in .claude/archive/ are history and must never be edited, and new versioned roadmap files should never be created.

What happens if no tasks.md or roadmap file exists in the repo?

The protocol skips entirely. If dynamic discovery finds no matching checklist or roadmap files at the repository root or in docs/, no gating steps are performed.

Why should documentation updates be in the same commit as code?

Atomic commits keep progress tracking consistent with the actual codebase state, so any commit in history accurately reflects both the implementation and its recorded completion status.