Display Name
roadmap-pilot
Category
Agent Skills
Sub-Category
None
Primary Link
https://github.com/antconsales/roadmap-pilot
Author Name
antonioconsales
Author Link
https://github.com/antconsales
License
MIT
Other License
MIT
Description
Roadmap-driven autopilot for Claude Code that splits large refactoring into two skills: /init-roadmap scans the project, interviews the user, and generates a phased checklist in CLAUDE.md; /roadmap then executes exactly one task per session, marks it done, commits, and hands off. Includes an autopilot shell script that chains sessions automatically, a visual progress dashboard, safe rollback, 7 ready-to-use templates, and a 30-test regression suite with CI on Ubuntu and macOS.
Validate Claims
- Copy the
.claude/ folder into any TypeScript or Python project
- Run
/init-roadmap — Claude will scan the project and generate a CLAUDE.md with a phased roadmap
- Open a new session and run
/roadmap — Claude will execute exactly ONE task, mark it [x], commit, and stop
- Run
.claude/skills/roadmap-pilot/scripts/status.sh CLAUDE.md to see a visual progress bar per phase
- Open another session and run
/roadmap again — it picks up the next task automatically
No network requests are made. No elevated permissions required. All scripts are pure bash with no dependencies.
Uninstall: delete the .claude/ folder from your project.
Specific Task(s)
Install the skill into a project with 5+ untyped TypeScript files. Run /init-roadmap and tell Claude your goal is "add types to all files". It will generate a phased CLAUDE.md. Then run /roadmap in a new session — it will type exactly one file, commit the change, and hand off. Run status.sh to see progress. Repeat /roadmap to see it pick up the next file each time.
Specific Prompt(s)
Session 1: /init-roadmap
When Claude asks your goal, say: "Add proper TypeScript types to all files. Shared types go in src/types/. Use type instead of interface. Branch: refactor/typing. Commit prefix: [typing]."
Session 2 (new session): /roadmap
Claude will read CLAUDE.md, find the first unchecked task, execute it, and commit.
Session 3 (new session): /roadmap
Same flow, next task. Each session = one task = one commit.
Additional Comments
I built this because I kept losing context during multi-file refactoring with Claude Code. The key insight is splitting planning (conversational, one-time) from execution (deterministic, repeatable). The CLAUDE.md acts as a contract between sessions. The auto-roadmap.sh script can chain 20+ sessions back-to-back using claude -p for fully hands-free execution. Tests and CI are included from day one.
Recommendation Checklist
Display Name
roadmap-pilot
Category
Agent Skills
Sub-Category
None
Primary Link
https://github.com/antconsales/roadmap-pilot
Author Name
antonioconsales
Author Link
https://github.com/antconsales
License
MIT
Other License
MIT
Description
Roadmap-driven autopilot for Claude Code that splits large refactoring into two skills: /init-roadmap scans the project, interviews the user, and generates a phased checklist in CLAUDE.md; /roadmap then executes exactly one task per session, marks it done, commits, and hands off. Includes an autopilot shell script that chains sessions automatically, a visual progress dashboard, safe rollback, 7 ready-to-use templates, and a 30-test regression suite with CI on Ubuntu and macOS.
Validate Claims
.claude/folder into any TypeScript or Python project/init-roadmap— Claude will scan the project and generate a CLAUDE.md with a phased roadmap/roadmap— Claude will execute exactly ONE task, mark it[x], commit, and stop.claude/skills/roadmap-pilot/scripts/status.sh CLAUDE.mdto see a visual progress bar per phase/roadmapagain — it picks up the next task automaticallyNo network requests are made. No elevated permissions required. All scripts are pure bash with no dependencies.
Uninstall: delete the
.claude/folder from your project.Specific Task(s)
Install the skill into a project with 5+ untyped TypeScript files. Run
/init-roadmapand tell Claude your goal is "add types to all files". It will generate a phased CLAUDE.md. Then run/roadmapin a new session — it will type exactly one file, commit the change, and hand off. Runstatus.shto see progress. Repeat/roadmapto see it pick up the next file each time.Specific Prompt(s)
Session 1: /init-roadmap
When Claude asks your goal, say: "Add proper TypeScript types to all files. Shared types go in src/types/. Use type instead of interface. Branch: refactor/typing. Commit prefix: [typing]."
Session 2 (new session): /roadmap
Claude will read CLAUDE.md, find the first unchecked task, execute it, and commit.
Session 3 (new session): /roadmap
Same flow, next task. Each session = one task = one commit.
Additional Comments
I built this because I kept losing context during multi-file refactoring with Claude Code. The key insight is splitting planning (conversational, one-time) from execution (deterministic, repeatable). The CLAUDE.md acts as a contract between sessions. The auto-roadmap.sh script can chain 20+ sessions back-to-back using claude -p for fully hands-free execution. Tests and CI are included from day one.
Recommendation Checklist