OpenAI Codex workflow course

Course goal: ship your personal brand site

Build a personal brand site with Codex

Keep improving one project from an empty folder to a responsive one-page site with an introduction, projects, and contact details. Every lesson adds a visible result or a check toward that finish line.

Curriculum

Personal brand site build path

Start With Codex

Set up Codex and build the hero section of your personal brand site.

0/4

00｜Install And Open CodexInstall the desktop app, sign in, open the site project folder, and send a safe first message.What Codex Is ForBuild the first version of your site with a name, introduction, projects, contact details, and one working button.Choose A Codex SurfaceEdit the site's Projects button locally, then verify its text and behavior in a browser.Your First Useful PromptTurn “add an About section” into a concrete request with content, constraints, and browser checks.

Prompt Like A Builder

Map the site, plan its sections, and turn rough ideas into clear changes.

0/3

Find the Files to ChangeAsk Codex to show which files control each part of the site before you edit anything.Plan Before CodingPlan the site's theme control before editing, including risks and browser checks.Define Done WhenDefine visible completion checks, then implement the site's light and dark themes.

Work Safely

Add site interactions while keeping every edit safe and easy to undo.

0/3

Local Thread BoundariesAdd Back to top while keeping the task limited to one file and one visible outcome.Sandbox And ApprovalsServe the personal site locally and review every command before approving it.Network Access RiskAudit fonts, images, scripts, and links to decide whether the site needs network access.

Ship Verified Changes

Test the site, check desktop and mobile views, and review the final diff.

0/3

Test The ChangeAdd focused checks for the site's theme and navigation without breaking earlier work.Browser VerificationOpen the real site and check content, navigation, and layout at desktop and mobile widths.Review Before AcceptingReview the site's full diff, test evidence, and any remaining visual or behavior risks.

Lock In Your Site Rules

Write project rules that preserve the site's content and visual style.

0/3

Write Your Site RulesWrite an AGENTS.md for my-brand-site so later edits keep the same voice, layout, and checks.Separate Site And Section RulesKeep permanent site rules separate from one-time requests for the Projects or Contact section.Turn Site Mistakes Into RulesTurn missed labels, broken links, or mobile overflow into rules that prevent the same problem next time.

Finish The Site Details

Use the app, CLI, or cloud where each remaining site task fits best.

0/3

Polish The Site In The AppUse the Codex app to polish one Projects card, review the diff, and check the result at two widths.Run Site Checks In The CLIUse the terminal to catch duplicate IDs, missing section links, and whitespace errors in the single-file site.

9 minReady

Run Site Checks In The CLI

Check the site's HTML with commands that fit the files the project actually has.

HTML checksexact command outputclean diff

Plain-language explanation

The site is still a simple index.html, so terminal checks should stay simple too. You can scan section IDs, match in-page links, and catch whitespace errors without adding a toolchain.

The important habit is using commands that fit the project in front of you, not copying npm commands from another lesson.

Why it matters

Small command-line checks catch easy-to-miss HTML problems and leave exact evidence for the final review.

Common beginner mistake

Beginners often ask for npm test even when the practice folder has no package.json or test script.

Step-by-step

Start in my-brand-site and inspect which files and tools exist.
List all id values and all links that start with #.
Compare them for duplicates or missing targets.
Run git diff --check when the folder is tracked, then report exact output.

Good prompt

Codex, use the CLI to inspect my-brand-site/index.html for duplicate IDs and broken in-page links. Run git diff --check if this folder is tracked. Report the exact commands and output, and do not invent npm scripts or add packages.

Try this

Ask Codex to print the page's section links and confirm that each target exists.

Completion checklist

Every command matches the files and tools that actually exist.
The result separates terminal findings from checks that still need a browser.

Sources

Codex CLI features

Delegate An Isolated Site TaskHand off a bounded content or accessibility audit without opening the door to a full redesign.

Build A Site QA Workflow

Create reusable checks for the site's content, links, and browser behavior.

0/3

Turn Site Checks Into A SkillPackage the personal site's pre-launch content, link, mobile, and accessibility checks into one reusable skill.Bring In Project Data SafelyDecide whether project cards need outside data, and use the smallest read-only connection only when it adds value.Test Contact SafelyTest the Contact section with sample data and stop before anything is sent to a real service.

Finish And Deliver The Site

Polish independent tasks in parallel, then complete one final acceptance review.

0/3

Complete The Site GoalTurn the finished personal site into one measurable goal with content, layout, interaction, and evidence checks.Polish Copy And Accessibility In ParallelUse isolated worktrees only when copy polish and accessibility review can avoid editing the same lines.Run The Final Three ReviewsRun separate content, link, and accessibility reviews, then compare all evidence against the same launch checklist.

Practice lab

Copyable Codex prompts

Plan before coding

Codex, inspect the relevant files first, then propose a plan. Do not edit until the plan names tests and verification steps.

Verification checklist

Relevant files are named before edits begin.
The plan includes tests and verification commands.

Verify a UI change

Codex, start the dev server, open the route in the browser, check desktop and mobile layouts, then report the exact evidence.

Verification checklist

Desktop and mobile states are checked in the browser.
The final note includes exact evidence.

Review focused risk

Codex, review the uncommitted diff. Focus on behavioral regressions, missing tests, and accessibility issues. Do not modify files.

Verification checklist

Findings lead with severity and file references.
Unchanged files are left untouched.

Every good Codex request says what to change, what to preserve, and how to prove it worked.

Reference

Build a personal brand site with Codex

Personal brand site build path

Start With Codex

Prompt Like A Builder

Work Safely

Ship Verified Changes

Lock In Your Site Rules

Finish The Site Details

Run Site Checks In The CLI

Plain-language explanation

Why it matters

Common beginner mistake

Step-by-step

Good prompt

Try this

Completion checklist

Sources

Build A Site QA Workflow

Finish And Deliver The Site

Copyable Codex prompts

Plan before coding

Verification checklist

Verify a UI change

Verification checklist

Review focused risk

Verification checklist

Codex concepts to keep nearby