Foreman

Toda buena construcción
empieza con un plano.

La conversación, las decisiones, el sistema visual aprobado y el brief.
Después, el código, el dominio y la indexación.

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.

Planifica el sitio antes de escribir código.

Pide un sitio y Foreman responde con su tarjeta y una pregunta. Di survey para reducir las preguntas: lee tu repositorio, tu sitio y tu CV en lugar de preguntar. Di stress test para profundizar: cuestiona cada respuesta una vez. Los tres modos cubren todas las decisiones.

Comparar modos

El modo predeterminado. La conversación completa, una pregunta a la 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.

Mira la diferencia.

Un portafolio creado con las mismas notas del proyecto. Primero, un borrador rápido. Después, una dirección visual, referencias seleccionadas y un brief aprobado.

Borrador inicial del portafolio. Portafolio de robótica guiado por referencias con un robot con carcasa de grafito y tipografía cinematográfica. Borrador inicialCon Foreman

Del brief a la publicación.

Ocho pasos, desde decidir qué construir hasta publicarlo. Selecciona un paso para ver un ejemplo.

El punto de partida

Define el sitio y reúne el material de partida.

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

Una guía que puedes leer.

Foreman es un conjunto de instrucciones y plantillas Markdown. Sin scripts, hooks ni servicios en segundo plano.

14

Referencias

Se cargan cuando llega su paso. Incluyen criterios de diseño: teoría del color, proporción, escala tipográfica, espaciado y tiempos de animación.

4

Herramientas

Board, Punch list, Palette y Launch: cada herramienta es un archivo y, en Claude Code, un comando con barra.

7

Plantillas

Una vista previa de marca, un tablero de referencias, un bloque head con Open Graph y JSON-LD, una página 404, robots.txt, sitemap.xml y llms.txt.

21

Modos de falla

Los puntos donde suelen fallar los proyectos, revisados en cada paso: desde construir sin planificar hasta editar DNS a ciegas.

Usa Foreman con tu agente.

Claude Code, Codex, Cursor, Copilot, Gemini CLI y otros agentes que leen instrucciones.

Clona el repositorio y agrega la carpeta Foreman a las habilidades o instrucciones de tu agente.

git clone https://github.com/Turki-Sh/Foreman.git
Elige tu agente

Ejecuta estos comandos en Claude Code.

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