References
Loaded only when their step arrives, including design standards: colour theory, proportion, type scale, spacing, motion timing.
The interview, the decisions, the locked system, the brief.
Then the code, then the domain, then indexed.
help me build my portfolio
It reads CV.md and project-notes.md, then sends its opening card.
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.
help me build my portfolio
Your notes say retraining "took most of a day" and now takes "about 40 percent of the old time." Roughly how many hours was it before and after, on which robot and task?
Non-goals, drafted from "email me, nothing else": no contact form (a plain email link), no analytics, no blog, no carousel, no scroll-triggered animation, no testimonials or stats band, no social links, no invented numbers. Hover and focus states stay.
BRIEF.md Recorded output
## CONTENT
Written by Dana, moved and cut, not generated. Use verbatim.
Opening (h1): Retraining after each hardware change took most
of a day. Now it takes about 40 percent of that.
Support: MSc Robotics (expected 2027), research assistant at
the Legged Locomotion Lab, applying for PhD positions in
legged robotics.
Action: button, label "Email dana.haddad@example.org",
destination `mailto:dana.haddad@example.org`.
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.
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.
Research group leads hiring PhD students in legged robotics.
The fewest questions. Research first, then one sheet with a source on every line.
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:
The most thorough. The same interview, and every answer is pushed once before it locks.
/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.
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 draftWith Foreman
Eight steps, from deciding what to build to getting it online. Select a step to see an example.
Define the site and collect the source material.
Site: research portfolio
Reader: robotics research group lead
Material: CV and project notesChoose the reader, action, content, and scope.
Action: email about a PhD position
Include: research, background, contact
Leave out: blog, analytics, contact formSelect references and agree on the visual system.
References: selected pages and components
Typography: type scale and reading widths
Colour: surfaces, text, borders, statesPut the decisions into one build brief.
Purpose and audience
Approved content
Visual system and references
Page structure
Acceptance checksBuild the site from the approved brief.
Responsive pages
Working navigation and actions
Metadata and error pageCheck layout, content, accessibility, and controls.
Desktop and mobile layout
Keyboard access and focus
Contrast and reduced motion
Links, copy controls, and error handlingConnect the domain and deploy the site.
Hosting destination
Domain and HTTPS
Redirects and custom 404
Existing email records preservedCheck search metadata and sharing previews.
Titles and descriptions
Open Graph previews
Sitemap and robots.txt
Search console submissionCall one on its own, or in the middle of a session without losing your place. In Claude Code each is a slash command. Anywhere else, ask in plain words.
Real sites chosen for your brief, as a list or a visual board with screenshots, ending in the principles worth taking from them.
A reference for navigation.
A reference for typography.
A reason to use each one.
Audits any site, including ones Foreman never touched, for what makes it look AI-generated or unfinished, ranked, with a fix for each.
13 items: 2 broken, 4 unfinished, 4 generated, 3 notes
1. Header nav at 375. Nothing replaces it, so phone
visitors cannot reach Install or switch theme.
Three palettes from a material you name, contrast checked, on your real content. You pick one.
A Cyanotype print #1B4A73 #F2BE3C
B Drafting film #F3F4F1 #1F4F7A
C Graphite, redline #1F2327 #EC6A55
Domain, DNS, SSL, the share card, a real 404, the sitemap and indexing, one step at a time, for a site built anywhere.
done Email untouched MX and SPF still on the apex
done 404 status /nope returns 404, own page
open Search Console submit sitemap.xml
Foreman is a set of Markdown instructions and templates. No scripts, hooks, or background services.
Loaded only when their step arrives, including design standards: colour theory, proportion, type scale, spacing, motion timing.
Board, punch list, palette and launch, each one file and, in Claude Code, a slash command.
A brand harness, a reference board, a head block with Open Graph and JSON-LD, a 404, robots.txt, sitemap.xml and llms.txt.
The places builds actually die, watched for at every step, from skipping to the build to editing DNS blind.
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.gitRun these commands in Claude Code.
/plugin marketplace add Turki-Sh/Foreman
/plugin install foreman@alshuaibi