Codex learning page for this workspace
Codex Field Guide

Learn how to get real work done with Codex

Codex works best when you use it like a careful technical teammate: give it the outcome, give it the local context, say what is risky, and ask it to verify the result. This page turns that idea into a practical guide you can reread while you learn.

The shortest useful mental model is: ask clearly, constrain risk, review the work, and close the loop with verification.

1. Outcome Tell Codex the finish line, not just the topic.
2. Context Include the repo, file, bug symptom, customer, or workflow.
3. Constraints Say what not to touch and what must stay safe.
4. Verification Ask it to test, check, confirm, or explain failure.
Prompting Basics

The beginner prompt formula

Most weak results come from requests that are too vague. You get better work when every request names the goal, scope, constraints, and definition of done.

Best default sentence: “I’m new to this. Keep it safe, show the preview first, and explain the best practice while you do it.”

Prompt formula

  1. Goal: what you want completed.
  2. Scope: where it lives and what area matters.
  3. Constraints: safety rules, style rules, and do-not-touch rules.
  4. Done means: what output you want back from Codex.

Good context to include

  • The file or folder name
  • The visible bug or error text
  • The expected behavior
  • Whether this is draft-only or real execution
  • Anything that must not be changed
Fix the signup bug in this workspace.
The problem is that the submit button does nothing on mobile.
Only change the signup flow files and do not touch styling outside that flow.
Run the relevant check and tell me exactly what changed.
How Codex Operates

What usually happens after you ask

Understanding the internal rhythm helps you collaborate better. Codex will usually inspect the workspace first, decide on a path, make changes, and then verify what it did.

Read It checks files, folder structure, current code, or previous content before acting.
Plan It decides what needs to change and what should stay untouched.
Edit It updates the relevant file or files based on your request.
Verify It runs tests, checks results, or tells you clearly what could not be verified.
Working Modes

Preview mode vs execution mode

This is one of the most useful distinctions for a beginner. Start with preview when there is risk. Use execution when the task is bounded and you are ready for the change.

Preview

Use this when you want a safe proposal first.

  • Draft the email but do not send it
  • Show the automation setup but do not activate it
  • Explain the code change before editing
  • Prepare options for review
Execution

Use this when the task is clear and you want real action.

  • Fix the bug in the specified file
  • Update the HTML page in this workspace
  • Run the check and report the result
  • Create the local document or draft
Useful Job Types

Common things you can ask Codex to do

A lot of beginners underuse Codex by asking only broad questions. It is usually better at concrete tasks with a visible output.

Code and bugs

  • Find the cause of an error
  • Fix a specific broken flow
  • Explain a file in plain English
  • Run the relevant test or check

Documents and HTML

  • Create or expand a guide page
  • Rewrite copy to be clearer
  • Turn notes into a readable document
  • Improve layout while keeping content intact

CRM and outreach

  • Read recent lead context
  • Summarize prior touchpoints
  • Draft a reply in your tone
  • Separate drafting from sending
Safe Habits

What to say when something has risk

Codex becomes much safer when you tell it exactly what it must not do. These lines are short, but they prevent a lot of mistakes.

High-value safety phrases

  • Do not send anything
  • Preview only
  • Do not delete files
  • Only work in this folder
  • Do not rewrite unrelated code
  • Start paused

Good definition of done

  • Show me the edited file
  • Summarize the changes in plain English
  • Run the relevant check
  • Tell me what failed if verification failed
  • Leave the result as a local draft
Common Mistakes

Why beginners often get weaker results

The issue is usually not that Codex cannot do the task. The issue is that the request does not create a clear target or safe boundary.

Weak ask

“Check this repo.”

Too open-ended. There is no finish line and no clue what matters.

Better ask

“Find why login fails, fix only the login flow, run the relevant check, and summarize the change.”

Clear goal, clear scope, clear verification.

Common beginner errors

  • Asking something vague with no success criteria
  • Forgetting to say what is risky
  • Requesting too many unrelated tasks at once
  • Not asking for verification at the end

Better learning pattern

  1. Ask for one small task.
  2. Review the output or preview.
  3. Let Codex do one real execution.
  4. Ask what worked and what to improve next time.
Learning Ladder

A simple way to educate yourself fast

If you want to get good quickly, do not jump straight into high-risk automation. Build your habits in stages.

Week 1 focus

  • Ask Codex to explain files and folders
  • Have it make one safe local edit
  • Ask it to improve one document or HTML page
  • Compare weak prompts against better prompts

Week 2 focus

  • Ask it to fix a small bug and verify it
  • Use preview mode for emails or automations
  • Start saving prompt patterns that worked well
  • Learn to separate drafting, review, and action
Templates

Starter prompts you can reuse

These are written to be practical. Replace the nouns and keep the structure.

Understand a codebase area
Read this folder and explain how it works in plain English.
Focus on the main files, the data flow, and what I should read next.
Do not edit anything.
Fix one bug safely
Find why this feature is failing, fix only the relevant files, and verify the result.
Do not rewrite unrelated code.
Tell me exactly what changed and what check you ran.
Draft, do not send
Read the recent context for this lead and draft the next reply in my tone.
Do not send anything.
Show me the draft and explain why it matches the context.
Create a learning document
Build me a readable HTML page in this workspace that teaches me this system as a beginner.
Keep the design clean and make the content practical.
Include examples, mistakes to avoid, and reusable prompt templates.
Automation preview
Create a suggested automation for this workflow.
Keep it paused and do not activate anything.
I want a reviewable draft output first, not automatic sending.