Foreman

Foreman Your plan stays next to your code. The next task arrives with its context checked.

Available on

Get started · What is this? · How it works · What you can do · Evidence

What is this?

You finish a session with a fix, a side request and an issue still waiting. Next time, you need to know which one comes first and why. Foreman keeps that context in a roadmap beside your code.

Ask "what’s next?" and it recommends a task with its reason and a prompt checked against the project’s files. Completed work brings evidence back into the plan; acceptance stays a separate decision.

Why you'd want it

• Pick up where the last session stopped.
• Keep the task, its reason and its constraints together.
• Check stale plans against the code before acting.
• Keep acceptance of finished work separate from a successful test run.

How it works

The roadmap lives in your project. Foreman reads it, checks the relevant context and helps you choose what to do next.

What you can do

You want to	Outcome
Add work to the roadmap	Requested work recorded with its reason and boundaries
See where things stand	Status, blockers and work waiting for acceptance
Choose the next task	A recommended task and a choice of where to run it
Check whether the plan still matches the code	A grounded review before choosing work
Get a prompt for one-off work	A checked handoff without requiring a roadmap entry

How to ask

Plain sentences work in every assistant: "add this to the roadmap", "where are we?", "what's next?", "check whether the plan still matches the code" or "craft a prompt for this". If you would rather call Foreman by name, each assistant has its own way:

You want to…	Claude Code	Codex	Antigravity
Ask in your own words	/foreman:foreman	the foreman skill	/foreman
Set up a roadmap for a project (once)	/foreman:init	the init skill	/init
Pick, add, correct or review work	/foreman:roadmap	the roadmap skill	/roadmap
Check the plan against your code	/foreman:survey	the survey skill	/survey
Write a one-off prompt with no roadmap entry	/foreman:craft-prompt	the craft-prompt skill	/craft-prompt

Install

Foreman is one plugin for the three assistants. Install it in the one you use; only the commands differ.

Codex

Requirements: Node.js and Git (tested with Node.js 22), and a Codex host with plugin support.

codex plugin marketplace add V-Songbird/foundry
codex plugin add foreman@foundry

Review and trust its hooks with /hooks, then start a new Codex session. Ask Foreman to initialize the project, or select its installed init skill.

Claude Code

Requirements: Node.js and Git (tested with Node.js 22). In Claude Code, Foreman needs version 2.1.147 or later.

Inside Claude Code:

/plugin marketplace add V-Songbird/foundry
/plugin install foreman@foundry

Start a new session to load the plugin. Run /foreman:init once in the project.

Antigravity