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.
La conversación, las decisiones, el sistema visual aprobado y el brief.
Después, el código, el dominio y la indexación.
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`.
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.
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.
Research group leads hiring PhD students in legged robotics.
El mínimo de preguntas. Primero investiga y después presenta una hoja con una fuente en cada línea.
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:
El más exhaustivo. La misma conversación, pero cada respuesta se cuestiona una vez antes de aprobarla.
/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.
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 inicialCon Foreman
Ocho pasos, desde decidir qué construir hasta publicarlo. Selecciona un paso para ver un ejemplo.
Define el sitio y reúne el material de partida.
Site: research portfolio
Reader: robotics research group lead
Material: CV and project notesElige el público, la acción, el contenido y el alcance.
Action: email about a PhD position
Include: research, background, contact
Leave out: blog, analytics, contact formSelecciona referencias y acuerda el sistema visual.
References: selected pages and components
Typography: type scale and reading widths
Colour: surfaces, text, borders, statesReúne las decisiones en un solo brief de proyecto.
Purpose and audience
Approved content
Visual system and references
Page structure
Acceptance checksConstruye el sitio a partir del brief aprobado.
Responsive pages
Working navigation and actions
Metadata and error pageComprueba el diseño, el contenido, la accesibilidad y los controles.
Desktop and mobile layout
Keyboard access and focus
Contrast and reduced motion
Links, copy controls, and error handlingConecta el dominio y publica el sitio.
Hosting destination
Domain and HTTPS
Redirects and custom 404
Existing email records preservedComprueba los metadatos de búsqueda y las vistas previas al compartir.
Titles and descriptions
Open Graph previews
Sitemap and robots.txt
Search console submissionUsa una por separado o durante una sesión sin perder tu lugar. En Claude Code, cada una tiene un comando con barra. En otros agentes, pídela con palabras.
Sitios reales elegidos para tu brief, en una lista o un tablero visual con capturas de pantalla y los principios de diseño que vale la pena adoptar.
A reference for navigation.
A reference for typography.
A reason to use each one.
Audita cualquier sitio, incluso uno que Foreman no haya creado. Detecta lo que parece generado por IA o sin terminar y ordena los problemas por prioridad, con una solución para cada uno.
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.
Tres paletas inspiradas en un material que tú eliges, con el contraste comprobado sobre tu contenido real. Tú decides cuál usar.
A Cyanotype print #1B4A73 #F2BE3C
B Drafting film #F3F4F1 #1F4F7A
C Graphite, redline #1F2327 #EC6A55
Dominio, DNS, SSL, vista previa al compartir, una página 404 funcional, mapa del sitio e indexación, paso a paso, para cualquier sitio.
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 es un conjunto de instrucciones y plantillas Markdown. Sin scripts, hooks ni servicios en segundo plano.
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.
Board, Punch list, Palette y Launch: cada herramienta es un archivo y, en Claude Code, un comando con barra.
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.
Los puntos donde suelen fallar los proyectos, revisados en cada paso: desde construir sin planificar hasta editar DNS a ciegas.
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.gitEjecuta estos comandos en Claude Code.
/plugin marketplace add Turki-Sh/Foreman
/plugin install foreman@alshuaibi