Profile-Guided Optimization for AI Agents is licensed under the Creative Commons Attribution 4.0 International License (CC BY 4.0).
You are free to:
Under the following terms:
unknowns-first-coding is a Codex skill for risky coding tasks where a wrong assumption would be expensive.
The main idea: before implementing, Codex should separate what is known from what is guessed. It should inspect the repo first, surface important unknowns, ask only questions that materially change the implementation, and proceed on low-risk reversible choices with assumptions clearly logged.
This is not a planning ceremony for every edit. Tiny deterministic changes should stay lightweight: inspect, edit, validate, summarize. The full workflow is for ambiguity with real reversal cost: architecture, public APIs, schemas, migrations, production data, security/privacy/auth/payments/compliance, large refactors, or risky UX semantics.
Codex skill for turning loose coding intent into a verified work loop:
intent -> contract -> SPEC/Plan/tracker/prompt -> execution evidence
It captures the outcome, evidence, edit boundaries, tools, iteration policy, budgets, pause conditions, and task acceptance criteria before the agent starts work.