Foreman

Every good build
starts as a drawing.

The interview, the decisions, the locked system, the brief.
Then the code, then the domain, then indexed.

Claude Code / dana-portfolio
Claude CodeForeman 3.0.1 · A portfolio, from brief to build

help me build my portfolio

It reads CV.md and project-notes.md, then sends its opening card.

FOREMAN · 1/8 · ORIENT

What are you building, and what do you already have?

Hi, I'm Dana. I'm a master's student in robotics applying for PhD positions, and I want a simple site for research group leads who hire legged robotics students. [...] I'd like a calm, light, notebook-style page, and I want visitors to email me, nothing else.

Plan the site before writing code.

Ask for a site and Foreman sends its card and one question. Say survey for the fewest questions: it reads your repo, your site and your CV instead of asking. Say stress test for the most: every answer gets pushed once. Every decision gets made in all three.

Compare modes

The default. The full interview, one question at a time.

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.

See the difference.

A portfolio built from the same project notes. First as a quick draft, then with a visual direction, selected references, and a locked brief.

Initial portfolio draft. Reference-guided robotics portfolio with a graphite-shell robot and cinematic typography. Initial draftWith Foreman

From brief to launch.

Eight steps, from deciding what to build to getting it online. Select a step to see an example.

The starting point

Define the site and collect the source material.

Site: research portfolio
Reader: robotics research group lead
Material: CV and project notes

A playbook you can read.

Foreman is a set of Markdown instructions and templates. No scripts, hooks, or background services.

14

References

Loaded only when their step arrives, including design standards: colour theory, proportion, type scale, spacing, motion timing.

4

Tools

Board, punch list, palette and launch, each one file and, in Claude Code, a slash command.

7

Templates

A brand harness, a reference board, a head block with Open Graph and JSON-LD, a 404, robots.txt, sitemap.xml and llms.txt.

21

Failure modes

The places builds actually die, watched for at every step, from skipping to the build to editing DNS blind.

Use Foreman with your agent.

Claude Code, Codex, Cursor, Copilot, Gemini CLI, and other agents that read instructions.

Clone the repository and add the Foreman folder to your agent’s skills or instructions.

git clone https://github.com/Turki-Sh/Foreman.git
Choose your agent

Run these commands in Claude Code.

/plugin marketplace add Turki-Sh/Foreman
/plugin install foreman@alshuaibi