learn-codex-with-phoebe / Session 4 of 6
Learn Codex with Phoebe · Session 4 of 6

Design and content: make it yours

The skeleton from Session 2 becomes a real site today: all three sections filled with your actual bio, your actual builds, your actual ideas - then polished through a critique loop until the design is something you're proud to send people.

🟡 Medium Builders 45 min live + self-study
0-3 · Welcome 3-15 · Raw material 15-35 · Polish loops 35-45 · Pro pass + Q&A
Part 0

From skeleton to something you'd actually send people

Right now your site is a well-built empty house: Session 2's homepage skeleton, guarded by Session 3's AGENTS.md and skills. Today it gets furniture - three finished sections built from YOUR notes, in YOUR voice, with a design that survives a screenshot. This is the session where the project stops being an exercise and starts being your website.

★ What you walk out with today All three sections (about / showcase / ideas) built from your Session 1 notes file, at least two full design polish loops completed, and an accessibility + mobile pass done - the site Session 5 will put on the internet.
Part 1 · the raw-notes-to-pages workflow

Pages from raw material 8 min live

The Session 1 homework - a plain notes file with your bio, your builds, your ideas - was the real work. Today's rule: notes first, generate second. Codex shapes your material; it never invents it.

LiveNotes first, generate second4 min

Ask an AI to "write my about page" from nothing and you get a plausible stranger: confident, generic, and not you. Give it real raw material and a job description, and it becomes what it's actually good at - an editor. The difference is one prompt:

Weak - invites inventionWrite an impressive about section for me. I work in data and AI.
Strong - GCOB, notes as the source of truthGoal: build all three sections of my site - about, showcase, ideas - from notes.md in this folder. Context: notes.md is the source of truth for facts and voice. Use $site-design-system for all layout and styling decisions. Output: the three sections finished in index.html/style.css, plus a short list of every place you changed my wording and why. Boundaries: content verbatim where it's good, tighten where it rambles - but never add facts, credentials, or adjectives that aren't in my notes. Flag anything that sounds like filler instead of writing around it.
  • Verbatim where it's good: your best lines survive untouched - that's what keeps the page sounding like you.
  • Tighten where it rambles: editing is the job you're delegating, not authorship.
  • Flag, don't pad: "flag anything that sounds like filler" turns Codex into an honest editor instead of a content mill.
LiveKeeping YOUR voice - the skill does the guarding2 min

You encoded your voice once, in Session 3's $content-voice skill - sentence length, warmth, the words you'd never use. Now it earns its keep: every content prompt today runs under it, so you're not re-explaining your taste in every message.

  • Invoke it explicitly when content is the point: "use $content-voice for all copy in this pass".
  • When output drifts ("that doesn't sound like me"), fix the skill, not just the page - the correction then applies forever.
Real world

A learner's first generated bio opened with "As a passionate, results-driven professional..." - three things her $content-voice skill banned. One message ("re-read $content-voice, then rewrite the bio") fixed the page. Adding "never open with 'As a...'" to the skill fixed every future page too.

Self-studyWhat "good raw material" looks like2 min read
Same notes, three jobs: what Codex does with each section ABOUT short honest bio + 2-3 specifics tightens, orders, keeps your phrasing SHOWCASE 3-5 builds: what, why, one result formats into cards, asks when vague IDEAS 2-3 rough paragraphs, unpolished ok trims to crisp notes, flags gaps Codex shapes your material; it never invents it. Notes first, generate second.
🔍 Click to zoom - same raw notes become three different editing jobs
SectionRaw material that worksWhat Codex does with it
AboutA short honest bio + 2-3 specifics (what you do, what you care about)Tightens, orders, keeps your phrasing
Showcase3-5 builds, one line each: what it is, why it exists, one real resultFormats into cards, asks when a line is vague
Ideas2-3 ideas as rough paragraphs - unpolished is fineTrims to crisp notes, flags where you trailed off

Thin notes are fixable: ask Codex to interview you. "Ask me five questions that would make my showcase entries concrete" fills gaps with YOUR answers, not its guesses.

Part 2 · the design polish loop

The design polish loop 10 min live

Codex can look at a screenshot of your page and critique it like a designer - then fix what it found. Screenshot, critique, fix, reload: run the loop until the page survives a hard look.

1 · 📸 Screenshot capture the page as it really looks 2 · 🔎 Critique Codex reads it like a designer 3 · 🛠️ Fix apply the top-ranked fix only 4 · 🔄 Reload look again with fresh eyes one loop ≈ 2 minutes one fix per loop - batch fixes hide which one worked Stop condition: you screenshot the page and have nothing left to complain about. Usually 3-5 loops.
🔍 Click to zoom - the polish loop: screenshot → critique → fix → reload, repeat until proud
LiveThe structured critique prompt4 min

"Make it prettier" gets you random churn. A structured critique gets you a designer's read. Screenshot the page (full window), drop the image into Codex, and send this:

★ The critique prompt - reuse every loopHere's a screenshot of my site as it renders right now. Critique it like a designer reviewing a junior's work: 1. First impression - what does this page say about its owner in 3 seconds? 2. Hierarchy - does the eye land where it should? What competes? 3. Contrast - anything hard to read or too timid to notice? 4. Spacing - where is it cramped, where does whitespace go to waste? 5. Consistency - fonts, colors, spacing units: what breaks the system? Then give me your top 3 fixes, ranked by impact. Don't change anything yet.
  • "Don't change anything yet" keeps critique and fix as separate moves - you stay the editor-in-chief.
  • Apply fix #1 only, reload, re-screenshot. If the critique was right, the next loop's complaints get smaller.
  • Disagree freely: "I like the big name, skip fix 2" is the loop working, not failing.
LiveTaste rules - the three that do most of the work2 min
  • One accent color. One. Everything else is ink, paper, and grays. The second accent is where template-smell starts.
  • Whitespace is a feature. When in doubt, add space, not elements. Cramped reads as amateur faster than any font choice.
  • Kill anything that looks templated. Stock hero gradients, three-icon feature rows, "Lorem"-shaped copy - if you've seen it on a thousand sites, it's hiding you.
These live in your skill already Session 3 baked rules like these into $site-design-system - which is why today's fixes stay coherent instead of drifting. When a critique loop surfaces a taste rule you keep repeating, add it to the skill.
Self-studyWhen the loop stalls - three escape hatches2 min read

Around loop three or four, critiques sometimes turn cosmetic ("maybe 2px more padding") while the page still feels off. That's not done - that's stalled. Three ways out:

  • Ask for a bolder read: "Forget small fixes - if you redesigned ONE thing about this page to make it memorable, what would it be?" You can always say no.
  • Bring a reference: screenshot a site whose feel you admire and ask "what does this page do that mine doesn't - structurally, not content?" Borrow the principle, never the look.
  • Change one variable, hard: double the type scale, or strip every border, or try the accent somewhere unexpected. Reload, react, keep or revert. Git (next session) makes this fearless.
Know when you're done Done is not "nothing left to improve" - it's "I'd send this URL without apologizing." Ship at that bar; keep looping after it's live.
Part 3 · the professional pass

The professional pass 6 min live

Pretty on your laptop isn't done. Done means it works on a phone, for someone using a keyboard, for someone with low vision, and on a slow connection. One audit prompt covers the ground.

LiveThe audit prompt - responsive + accessibility in one pass3 min
★ The professional-pass promptAudit this site for accessibility and mobile issues: - responsive: layout at phone width, menu usability, nothing overflowing - contrast: text vs background, including text over images - alt text: every meaningful image described, decorative ones marked - heading order: one h1, no skipped levels - keyboard: can I reach and use every link and button with Tab alone? - performance sanity: flag any image over ~300KB Fix what's safe to fix without changing the design. List anything that needs my judgment instead of deciding for me.

"Fix what's safe, list what needs my judgment" is the key move - contrast tweaks and alt text are safe; "your gray-on-gray ideas section fails contrast, want a darker ink or a lighter card?" is a design decision that stays yours.

Performance sanity: does this image clear the line? ~300KB limit ~4MB Flag images over ~300KB: a 4MB hero photo is the gap between instant and "is this broken?"
🔍 Click to zoom - a 4MB hero image blows past the ~300KB line the audit flags
Self-studyThe professional-pass checklist3 min read
CheckHow to verifyWhy it matters
Phone-width layoutResize the browser narrow, or open on your phoneMost visitors arrive from a phone - a LinkedIn tap, not a desktop bookmark
Mobile menuEvery section reachable at narrow widthA nav that vanishes on mobile is a site with one page
ContrastSquint test + ask Codex to check ratiosLow-contrast "elegant" gray is unreadable in sunlight and fails real users
Alt textEvery meaningful image has a real descriptionScreen readers, broken images, and image search all read it
Heading orderOne h1, then h2/h3 without skipsIt's the document's outline - assistive tech navigates by it
Keyboard navPut the mouse down, Tab through the whole pageIf you can't reach it by keyboard, some visitors can't reach it at all
Image sizesNothing silly-large; ask Codex to flag >300KBA 4MB hero photo is the difference between instant and "is this broken?"
Demo 1 of 3

Build the three sections from your notes ★ 12 min · everyone builds

Open your project and confirm your notes file is in it. Thin notes? Two minutes now: one honest line per build, one rough paragraph per idea.

Run the Part 1 GCOB prompt - notes as source of truth, $site-design-system for layout, verbatim/tighten/flag boundaries. Let Codex build all three sections.

Now the important part: read what it wrote ABOUT YOU, slowly. Not the code - the words. Does the bio sound like you? Are the showcase claims true?

Find the exaggeration - there's almost always one - and fix it: "It made my dashboard project sound grander than it is - I built it for one team, not 'transformed the organization'. Tone it down to what actually happened."

Check the flags: everywhere Codex marked filler, either supply a real detail or cut the line. No padding survives.

Real world

This is the discernment moment of the whole course. The tool will happily inflate you - "spearheaded", "cutting-edge", "at scale" - and it reads as fake to everyone who actually knows you. The learners whose sites land are the ones who caught the inflation and toned it DOWN. Accurate and modest beats grand and hollow, every time.

Demo 2 of 3

Two full polish loops ★ 8 min · everyone loops

Loop 1: screenshot the full page, drop it into Codex with the structured critique prompt from Part 2. Read the three ranked fixes.

Apply fix #1 only - "apply your first fix, nothing else" - then reload and look. Better? Worse? Say so.

Loop 2: fresh screenshot, same prompt. Notice the complaints got smaller - that's the loop converging.

Apply the new top fix. Two loops in under eight minutes - now you know the cycle you'll run for the rest of this site's life.

Overruling is allowed If a critique says "the name is too big" and you LIKE the big name, say "keeping the big name - it's the point. Apply fix 2 instead." Codex critiques; you decide. That division of labor is the whole loop.
Demo 3 of 3

The audit ★ 4 min · follow along

Run the Part 3 audit prompt - accessibility + mobile, fix what's safe, list what needs judgment.

Watch what it fixes silently (alt text, a contrast nudge, a heading-order swap) and read the judgment list out loud.

Make one judgment call from the list, then open the site on your actual phone. That's the render that matters.

After the session

This week ◐ 45 min total

Check yourself

Three questions before you go 🎯 ◐ 90 seconds

1 · Why does the workflow insist on notes first, generate second?

Codex shapes your material; it never invents it. "Verbatim where good, tighten where rambling, never add facts" is the boundary that keeps the page yours.

2 · The polish loop, in order:

Screenshot what's real, get a ranked critique, apply the TOP fix only, reload with fresh eyes. One fix per loop - batching hides which change worked.

3 · The accessibility pass catches...

Contrast, alt text, heading order, keyboard nav - plus the mobile layout and oversized images. Fix what's safe; design trade-offs stay your call.

Source material

Official sources covered

This session applies OpenAI's official prompting and iteration guidance to real content and design work - docs at learn.chatgpt.com and free courses at OpenAI Academy.

Prompting guide (official docs), appliedGCOB on real content + the structured critique prompt - Parts 1-2
Codex for Work (OpenAI Academy)content-from-raw-material workflows here; broader work patterns in Session 6
Codex 101 (OpenAI Academy) iteration patternsscreenshot-critique-fix loops + audit passes - Parts 2-3 and Demos 2-3

Session 4 cheat sheet · pin this

Raw-material ruleNotes first, generate second. Codex edits your facts and voice - it never invents them.
The content promptBuild from notes.md · use $site-design-system · verbatim where good, tighten where rambling · flag filler · never add facts.
The polish loopScreenshot → critique → fix → reload. One fix per loop, 3-5 loops to proud.
The critique promptFirst impression · hierarchy · contrast · spacing · consistency · top 3 fixes ranked · "don't change anything yet".
Taste rulesOne accent color · whitespace is a feature · kill anything that looks templated.
The pro pass"Audit for accessibility + mobile; fix what's safe, list what needs my judgment." Then open it on your actual phone.