Foreman

Ogni buon sito
inizia con un disegno.

Il colloquio, le decisioni, il sistema visivo definito, il brief.
Poi il codice, il dominio e l’indicizzazione.

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.

Progetta il sito prima di scrivere codice.

Chiedi un sito e Foreman presenta la sua scheda e una domanda. Di’ survey per ridurre le domande: legge il repository, il sito e il CV invece di chiedere. Di’ stress test per approfondire: ogni risposta viene messa in discussione una volta. Le decisioni sono le stesse in tutte e tre le modalità.

Confronta le modalità

La modalità predefinita. Il colloquio completo, una domanda alla volta.

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.

Guarda la differenza.

Un portfolio creato dagli stessi appunti di progetto. Prima una bozza rapida, poi una versione con direzione visiva, riferimenti scelti e un brief approvato.

Bozza iniziale del portfolio. Portfolio di robotica basato su riferimenti, con un robot dal guscio color grafite e una tipografia cinematografica. Bozza inizialeCon Foreman

Dal brief alla pubblicazione.

Otto passaggi, dalla scelta di cosa costruire alla pubblicazione online. Seleziona un passaggio per vedere un esempio.

Il punto di partenza

Definisci il sito e raccogli il materiale disponibile.

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

Una guida che puoi leggere.

Foreman è un insieme di istruzioni e modelli Markdown. Nessuno script, hook o servizio in background.

14

Riferimenti

Caricati solo al passaggio pertinente, compresi gli standard di design: teoria del colore, proporzioni, scala tipografica, spaziatura e tempi delle animazioni.

4

Strumenti

Board, Punch list, Palette e Launch: un file ciascuno e, in Claude Code, un comando slash.

7

Modelli

Un’anteprima del sistema visivo, una tavola di riferimenti, un blocco head con Open Graph e JSON-LD, una pagina 404, robots.txt, sitemap.xml e llms.txt.

21

Cause di fallimento

I problemi che fanno davvero fallire un progetto vengono controllati a ogni passaggio: dal programmare troppo presto alle modifiche DNS senza verifica.

Usa Foreman con il tuo agente.

Claude Code, Codex, Cursor, Copilot, Gemini CLI e altri agenti che leggono istruzioni.

Clona il repository e aggiungi la cartella Foreman agli skill o alle istruzioni del tuo agente.

git clone https://github.com/Turki-Sh/Foreman.git
Scegli il tuo agente

Esegui questi comandi in Claude Code.

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