Foreman / Modes
Three modes, one set of decisions.
A mode changes how many questions Foreman asks and who does the legwork. It never changes which decisions get made. Say the word at any point to switch.
reader ? from: not in the README
action download Linkwell from: README, last line
job a reader downloads it and points it at their own
vault before closing the tab from: README, "existing Obsidian vault"
evidence 310 missed links in 2,400 notes, first week from: README, line 7
also: runs offline, 40 MB, MIT from: README
register technical from: README tone
non-goals signup, pricing, blog, analytics, testimonials,
carousel from: free, local-first, nothing to collect
opening "In my own vault of 2,400 notes it found 310
links I had missed in the first week" from: README, line 7
("Notes that link themselves" fits any notes app)
support "Watches a folder of Markdown notes and suggests
links as you type, on your laptop" from: README, line 5
below the 310 story, the three bullets, download
shape one viewport (under four content units) from: content count
| Mode | For | Before any code exists |
|---|---|---|
| Survey | You want it moving, or you already have most of the material | About four exchanges: two sheets, the variants, the brief. It researches, you correct |
| Blueprint | The default, and most builds | The full interview, one question at a time |
| Stress test | A launch where a weak decision costs real money or a real chance: a product, a job search, a fundraise | The full interview, with every answer pushed once |
Survey: research instead of asking.
Fewer questions usually means an agent takes the obvious answer, and the obvious answer is the average page. Survey moves the work instead of skipping it.
It researches before it asks anything. Your repo, the site you have now, your CV, your product's docs, the profiles you linked. If it can browse, it looks at four or five real sites in your category and notes what they all do, because that is the default to avoid.
One sheet instead of seven questions. The decisions arrive together, each with where it came from, and one question: what is wrong in it.
An assumption with no source is a question. A field research could not settle stays as
?, and the most important blank is the one it asks.Three things stay yours. You pick the palette from variants it built, the copy comes from your own sentences, and you sign off the brief.
I need a landing page for my app Linkwell, no time for a long process, can you just get it moving
Foreman sends its card. MODE reads Survey, because the message said there is no time.
It's Linkwell, a local-first notes app. Everything is in the README in this folder. I have a logo (logo.svg, not here yet), no domain.
It reads the README before it asks anything, then:
- Reader
- To confirm
- Action
- Download Linkwell
- Scope
- No signup, pricing, analytics, or blog
Blueprint: the full interview.
The default, and what Foreman always was. One step, one question, one message, and a thin answer gets a follow-up rather than a new question.
help me build my portfolio
Foreman sends its card. MODE reads Blueprint.
A portfolio. I have my CV and screenshots from a robotics project, nothing else yet.
Research group leads hiring PhD students in legged robotics.
Stress test: every answer pushed once.
For the build where a weak decision is expensive. Everything in Blueprint, plus:
- One challenge on every answer at steps 2 and 3 before it locks, never two.
- A pre-mortem before the brief freezes: it launched, a month passed, nobody took the action. Why?
- The reference board is part of the step, not an offer.
- A full punch list and a five-second stranger test before it ships.
/foreman:foreman stress test
Foreman sends its card. MODE reads Stress test.
A portfolio. I have my CV and screenshots from a robotics project, nothing else yet.
Research group leads hiring PhD students in legged robotics.
Switching.
Every session opens with a card, and the card carries a MODE line. Say survey, blueprint or stress test at any point and it carries on from the step you are on. Nothing already locked is reopened.
If your first message says you are short of time, it opens in Survey on its own. In Claude Code you can also start in a mode directly:
/foreman:foreman surveyWhere your agent can ask multiple-choice questions, Foreman uses them for any question it can make a good guess at, with its guess first and room for your own answer. Clicking costs a second. Typing costs a minute.