Briefing an AI coding agent to build this portfolio
Briefing an AI coding agent to build this portfolio, 2026 [Lab log] [Prototype]
A written art-direction brief, scripted reference captures and a screenshot review loop: how this site was designed and built with an AI coding agent — and where human judgement stayed essential.
Prototype — Works end to end in at least one real case; not yet proven repeatable.
Tools: OpenCode, Claude (Anthropic), Playwright, Astro
Context
I wanted a portfolio that looked art-directed, not templated — and I wanted to test whether an AI coding agent could carry a design brief from research to a working site without lowering the bar.
The starting point was not a prompt but a brief: positioning, navigation, content rules, three reference sites and what to take from each.
The workflow
Brief → Reference capture → Audit → Design system → Build → Review loop
Each step produced a file I could check before moving on.
Measuring instead of guessing
The agent drove a headless browser through each reference site at desktop and mobile sizes, saved screenshots and read the computed styles from the page: typefaces, sizes, line-heights, margins, media positions.
This turned “it feels precise” into numbers — for example margins that scale at roughly 2% of the viewport width. One reference sat behind a bot check, which only a visible browser window could pass.
{
"url": "https://example.com/work/project",
"name": "reference-case-study",
"viewports": [[1920, 1080], [1440, 900], [390, 844]],
"scrolls": [0, 0.25, 0.5, 0.75]
}Where judgement stayed human
Positioning, the honesty rules and the final call on every visual decision stayed with me. The agent was explicitly told never to invent clients, credits or results — so the site launches with clearly labelled placeholders rather than fake work.
The review loop mattered more than the first build: compiling is not the same as looking right.
Status
Result A working site, built once with this method
Reusable Capture script and review loop
Not yet proven Repeatability on a second, different project