Foreman

Tout bon site
commence par un dessin.

L’entretien, les décisions, le système visuel fixé, le brief.
Puis le code, le domaine et l’indexation.

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.

Planifiez le site avant d'écrire le code.

Demandez un site : Foreman présente sa carte et pose une question. Dites survey pour limiter les questions : Foreman consulte votre dépôt, votre site et votre CV. Dites stress test pour aller plus loin : chaque réponse est remise en question une fois. Les trois modes prennent les mêmes décisions.

Comparer les modes

Le mode par défaut. L’entretien complet, une question à la fois.

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.

Voyez la différence.

Un portfolio réalisé à partir des mêmes notes de projet. D’abord une ébauche rapide, puis une version avec une direction visuelle, des références choisies et un brief validé.

Ébauche initiale du portfolio. Portfolio de robotique inspiré de références, avec un robot à coque graphite et une typographie cinématographique. Ébauche initialeAvec Foreman

Du briefing au lancement.

Huit étapes, depuis la décision sur ce qu'il faut construire jusqu'à sa mise en ligne. Sélectionnez une étape pour voir un exemple.

Le point de départ

Définissez le site et rassemblez les éléments disponibles.

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

Quatre outils. Utilisez-les lorsque vous en avez besoin.

Utilisez un outil seul ou en cours de session sans perdre votre progression. Dans Claude Code, chacun dispose d’une commande slash. Avec les autres agents, demandez simplement ce dont vous avez besoin.

Un guide que vous pouvez lire.

Foreman est un ensemble d'instructions et de modèles Markdown. Pas de scripts, de hooks ou de services d'arrière-plan.

14

Références

Chargées seulement à l’étape concernée, notamment les règles de conception : théorie des couleurs, proportions, échelle typographique, espacement et rythme des animations.

4

Outils

Board, Punch list, Palette et Launch : un fichier chacun et, dans Claude Code, une commande slash.

7

Modèles

Une maquette de marque, un tableau de références, un bloc head avec Open Graph et JSON-LD, une page 404, robots.txt, sitemap.xml et llms.txt.

21

Causes d’échec

Les causes réelles d’échec sont surveillées à chaque étape : se précipiter sur le code, modifier les DNS sans vérification, et bien d’autres.

Utilisez Foreman avec votre agent.

Claude Code, Codex, Cursor, Copilot, Gemini CLI et autres agents qui lisent les instructions.

Clonez le dépôt et ajoutez le dossier Foreman aux skills ou aux instructions de votre agent.

git clone https://github.com/Turki-Sh/Foreman.git
Choisissez votre agent

Exécutez ces commandes dans Claude Code.

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