craft-prompt
Advanced surface, separate from Foreman's core roadmap job — a standalone prompt builder for work that has no roadmap entry…
@v-songbirdInstall SkillProductivity
Skill
/roadmap
Picks the next task from a project's ROADMAP.jsonl and crafts its handoff prompt, or adds, corrects, accepts, resumes, defers, archives or restores entries, reviews status, and checks the file's structural health. Ranks candidates deterministically by dependencies and file-touch
Claude Code
$ npx -y skills add V-Songbird/foreman --skill roadmap --agent claude-code
Codex
$ npx skills add V-Songbird/foreman --skill roadmap -a codex -y
Cursor
$ npx skills add V-Songbird/foreman --skill roadmap -a cursor -y
Gemini CLI
$ npx skills add V-Songbird/foreman --skill roadmap -a gemini-cli -y
GitHub Copilot
$ npx skills add V-Songbird/foreman --skill roadmap -a github-copilot -y
OpenCode
$ npx skills add V-Songbird/foreman --skill roadmap -a opencode -y
Windsurf
$ npx skills add V-Songbird/foreman --skill roadmap -a windsurf -y
SKILL.md
roadmap.SKILL.mdname: roadmap
description: "Picks the next task from a project's ROADMAP.jsonl and crafts its handoff prompt, or adds, corrects, accepts, resumes, defers, archives or restores entries, reviews status, and checks the file's structural health. Ranks candidates deterministically by dependencies and file-touch collisions and shows why each is where it is. Use when the user asks what to work on next, wants to add or fix a roadmap entry, or wants roadmap status. Not for first-time setup (init), checking entries against the code (survey), or a prompt with no roadmap entry (craft-prompt)."
when_to_use: "Trigger when the user asks what to work on next, wants to add something to the roadmap, wants to fix or reword an entry that already exists, wants to see roadmap status, thinks the roadmap file itself is broken, says \"what's next\", \"pick a task\", \"add to the roadmap\", \"that task's description is wrong\", \"roadmap status\", \"my roadmap is broken\", or invokes /foreman:roadmap."
argument-hint: "<optional — a task description to add, or a hint about what to pick next>"
allowed-tools: AskUserQuestion, Read, Write, Bash, PowerShell, TaskCreate, TaskUpdate, Agent, SendMessage
foreman:roadmap — pick, add to, correct, review, or check the project roadmap
Foreman runs in Claude Code, Codex and Antigravity. Every step applies to every host unless it names one. Read [the shared runtime](../foreman/runtime.md) 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](../../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](../init/SKILL.md) (`/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](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](pick.md) (`${CLAUDE_PLUGIN_ROOT}/skills/roadmap/pick.md`) and follow it.
---
Branch: Add a task
Read [add.md](add.md) (`${CLAUDE_PLUGIN_ROOT}/skills/roadmap/add.md`) and follow it.
---
Branch: Correct a task
Read [correct.md](correct.md) (`${CLAUDE_PLUGIN_ROOT}/skills/roadmap/correct.md`) and follow it.
---
Branch: Review status
Read [status.md](status.md) (`${CLAUDE_PLUGIN_ROOT}/skills/roadmap/status.md`) and follow it.
---
Branch: Check the roadmap
Read [doctor.md](doctor.md) (`${CLAUDE_PLUGIN_ROOT}/skills/roadmap/doctor.md`) and follow it.
Read more
name: roadmap description: "Picks the next task from a project's ROADMAP.jsonl and crafts its handoff prompt, or adds, corrects, accepts, resumes, defers, archives or restores entries, reviews status, and checks the file's structural health. Ranks candidates deterministically by dependencies and file-touch collisions and shows why each is where it is. Use when the user asks what to work on next, wants to add or fix a roadmap entry, or wants roadmap status. Not for first-time setup (init), checking entries against the code (survey), or a prompt with no roadmap entry (craft-prompt)." when_to_use: "Trigger when the user asks what to work on next, wants to add something to the roadmap, wants to fix or reword an entry that already exists, wants to see roadmap status, thinks the roadmap file itself is broken, says \"what's next\", \"pick a task\", \"add to the roadmap\", \"that task's description is wrong\", \"roadmap status\", \"my roadmap is broken\", or invokes /foreman:roadmap." argument-hint: "<optional — a task description to add, or a hint about what to pick next>" allowed-tools: AskUserQuestion, Read, Write, Bash, PowerShell, TaskCreate, TaskUpdate, Agent, SendMessage
foreman:roadmap — pick, add to, correct, review, or check the project roadmap
Foreman runs in Claude Code, Codex and Antigravity. Every step applies to every host unless it names one. Read [the shared runtime](../foreman/runtime.md) 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](../../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](../init/SKILL.md) (`/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](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](pick.md) (`${CLAUDE_PLUGIN_ROOT}/skills/roadmap/pick.md`) and follow it.
---
Branch: Add a task
Read [add.md](add.md) (`${CLAUDE_PLUGIN_ROOT}/skills/roadmap/add.md`) and follow it.
---
Branch: Correct a task
Read [correct.md](correct.md) (`${CLAUDE_PLUGIN_ROOT}/skills/roadmap/correct.md`) and follow it.
---
Branch: Review status
Read [status.md](status.md) (`${CLAUDE_PLUGIN_ROOT}/skills/roadmap/status.md`) and follow it.
---
Branch: Check the roadmap
Read [doctor.md](doctor.md) (`${CLAUDE_PLUGIN_ROOT}/skills/roadmap/doctor.md`) and follow it.
Stats
35
Stars
5
Forks
Active
Maintenance
JavaScript
Language
MIT
License
Last commit
Created
Ships withforeman
Project continuity for Claude Code and Codex: a roadmap beside your code, grounded handoffs, and clear task status.
355 skills
Stars on GitHub
Momentum
- stars in total
- 35
Other skills on foreman.
@v-songbirdInstall Skillforeman
The one entrance to Foreman, which keeps a project's plan and task history. Say what you want in plain language and this routes…
@v-songbirdInstall Skillinit
Bootstraps a project's ROADMAP.jsonl and .foreman/config.json from the user's goals and the repository, or appends to an existing…
@v-songbirdInstall Skillsurvey
Advanced surface, normally reached through the `foreman` entrance's Reconcile and pick mode, which hands it a near-term set of…
@v-songbirdInstall SkillMore skills from other plugins.
i-have-adhd
Shape output for a reader with ADHD: lead with the next action, number multi-step work, restate state across turns, suppress…
@ayghriInstall Skill
distilly
Set up the owner profile so a personal agent knows who it works for (first-run setup, \"get to know me\"), or distill colleague,…
@titanwingsInstall SkillQuestions about roadmap.
- Which coding agents can use roadmap?
- roadmap installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.