Foreman

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.

foreman survey 2/8 decisions (Linkwell, a test README)
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
ModeForBefore any code exists
SurveyYou want it moving, or you already have most of the materialAbout four exchanges: two sheets, the variants, the brief. It researches, you correct
BlueprintThe default, and most buildsThe full interview, one question at a time
Stress testA launch where a weak decision costs real money or a real chance: a product, a job search, a fundraiseThe 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.

  1. 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.

  2. One sheet instead of seven questions. The decisions arrive together, each with where it came from, and one question: what is wrong in it.

  3. 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.

  4. 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:

FOREMAN · SURVEY · 2/8 · DECISIONS
Reader
To confirm
Action
Download Linkwell
Scope
No signup, pricing, analytics, or blog
The download link in the README is github.com/example/linkwell/releases. I'll treat that as a placeholder until you give me the real URL. Who is the one reader: Obsidian users with a big vault, people who keep notes in plain Markdown, or someone else?

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.

FOREMAN · 2/8 · DECISIONS Logged: you have a CV and robotics screenshots. Still missing: any written copy, a domain, a logo, and a hero image or media. Who is the one reader you actually care about? Name a role, such as a hiring manager at a robotics lab or a research group lead. "Everyone" and "recruiters" in general don't count.

Research group leads hiring PhD students in legged robotics.

FOREMAN · 2/8 · DECISIONS Reader: a research group lead hiring PhD students in legged robotics. That reader scans fast and has a stack of CVs, so the page has to make you the exception inside ninety seconds. After those ninety seconds, what is the one thing you want them to do? Email you, open a paper, watch a demo, download the CV. Pick one.

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.

FOREMAN · STRESS TEST · 2/8 · DECISIONS ✓ LOCKED · 1/8 ORIENT · subject: portfolio · have: CV, robotics project screenshots · missing: written copy, other projects, logo, domain Who is the one reader you actually care about? Give me a named role, such as "research group lead hiring a PhD student" or "robotics startup CTO". "Recruiters" and "everyone" don't count.

Research group leads hiring PhD students in legged robotics.

FOREMAN · STRESS TEST · 2/8 · DECISIONS That reader is specific enough to build for. One push before it locks: a group lead skims dozens of applicants a week and has seen every "passionate about robotics" page. What would make that lead close your page within ten seconds?

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 survey

Where 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.