Foreman

Todo bom site
começa como um desenho.

A conversa, as decisões, o sistema visual definido, o briefing.
Depois, o código, o domínio e a indexação.

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.

Planeje o site antes de escrever o código.

Peça um site e Foreman apresenta seu cartão e uma pergunta. Diga survey para o menor número de perguntas: lê seu repositório, seu site e seu currículo em vez de perguntar. Diga stress test para uma análise mais profunda: cada resposta é questionada uma vez. Os três modos tomam as mesmas decisões.

Comparar modos

O padrão. A entrevista completa, uma pergunta de cada vez.

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.

Veja a diferença.

Um portfólio criado a partir das mesmas notas de projeto. Primeiro um rascunho rápido, depois uma versão com direção visual, referências selecionadas e um briefing aprovado.

Rascunho inicial do portfólio. Portfólio de robótica baseado em referências, com um robô de carcaça grafite e tipografia cinematográfica. Rascunho inicialCom Foreman

Do briefing ao lançamento.

Oito etapas, desde a decisão do que construir até colocá-lo online. Selecione uma etapa para ver um exemplo.

O ponto de partida

Defina o site e reúna o material disponível.

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

Um manual que você pode ler.

Foreman reúne instruções e modelos Markdown. Sem scripts, hooks ou serviços em segundo plano.

14

Referências

Carregadas apenas na etapa correspondente, incluindo padrões de design: teoria das cores, proporções, escala tipográfica, espaçamento e ritmo das animações.

4

Ferramentas

Board, Punch list, Palette e Launch: um arquivo por ferramenta e, no Claude Code, um comando de barra.

7

Modelos

Uma prévia de identidade visual, um quadro de referências, um bloco head com Open Graph e JSON-LD, uma página 404, robots.txt, sitemap.xml e llms.txt.

21

Modos de falha

Foreman observa as causas reais de falha em cada etapa, desde começar a programar cedo demais até alterar DNS sem verificar.

Use Foreman com seu agente.

Claude Code, Codex, Cursor, Copilot, Gemini CLI e outros agentes que leem instruções.

Clone o repositório e adicione a pasta Foreman aos skills ou às instruções do seu agente.

git clone https://github.com/Turki-Sh/Foreman.git
Escolha seu agente

Execute estes comandos em Claude Code.

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