foreman:roadmap — pick, add to, correct, review, or check the project roadmap
SkillFiles & storageOngoing entry point for a project's ROADMAP.jsonl. Pick the next task to work on (ranks candidates deterministically by dependencies and file-touch collisions, shows why each is where it is, then crafts a self-contained handoff prompt), add a new task, correct a stale one, accept, resume, defer, archive, or restore work, review roadmap status, or check the roadmap's structural health.
Use foreman:roadmap — pick, add to, correct, review, or check the project roadmap in Claude, ChatGPT or Ahel Desktop
Free. Sign in, add foreman:roadmap — pick, add to, correct, review, or check the project roadmap and connect your AI. About a minute.
Also: Claude Code · Cursor · Codex
Then ask your AI: use the foreman:roadmap skill
Details
Instructions available. Your AI can read the instructions. Execution depends on the setup they require.
Account requirements not reviewed. Check the skill instructions before use; Ahel provides instructions and does not run this skill.
No other account needed.
Add Ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.
What this skill tells your AI
The instructions your AI receives, as published by v-songbird/foreman in skills/roadmap/SKILL.md and read by Ahel’s review.
Foreman runs in Claude Code, Codex and Antigravity. Every step applies to every host unless it names one. Read the shared runtime first: it covers plugin paths, JSON payloads, questions and authorization for every host.
All reads/writes to ROADMAP.jsonl at the project root go through
${CLAUDE_PLUGIN_ROOT}/scripts/roadmap.js — never read or edit the file
directly, the script enforces id computation and parse-before/after-write
mechanically — run it as roadmap.js <subcommand> --help (for example
roadmap.js list --help) for that subcommand's shape. Read the
Fields section of roadmap-schema.md
(${CLAUDE_PLUGIN_ROOT}/roadmap-schema.md) if you need field semantics beyond
what's obvious from the names.
Pre-check: if ROADMAP.jsonl doesn't exist at the project root, offer to
set the project up with init (/foreman:init in Claude
Code) and stop here. When the user's request already includes setup, run init
directly instead.
A request the foreman entrance routed here names its branch: go straight to
that branch below. A direct /foreman:roadmap call, or a request handed over
without a branch, reads menu.md
(${CLAUDE_PLUGIN_ROOT}/skills/roadmap/menu.md) first: it holds the menu, the
phrasings that pick a branch without it, requests to archive or restore
finished work, and how its questions are logged.
Branch: Pick the next task
Read pick.md (${CLAUDE_PLUGIN_ROOT}/skills/roadmap/pick.md) and follow it.
Branch: Add a task
Read add.md (${CLAUDE_PLUGIN_ROOT}/skills/roadmap/add.md) and follow it.
Branch: Correct a task
Read correct.md (${CLAUDE_PLUGIN_ROOT}/skills/roadmap/correct.md) and follow it.
Branch: Review status
Read status.md (${CLAUDE_PLUGIN_ROOT}/skills/roadmap/status.md) and follow it.
Branch: Check the roadmap
Read doctor.md (${CLAUDE_PLUGIN_ROOT}/skills/roadmap/doctor.md) and follow it.
Signals
- GitHub stars
- 35
- Forks
- 5
- Last commit
- Sep 2026
Advanced
- Item type
- skill
- Key
roadmap-v-songbird- Source
- github.com/v-songbird/foreman