| MIT License | |
| Copyright (c) 2026 Steve Solun | |
| Permission is hereby granted, free of charge, to any person obtaining a copy | |
| of this software and associated documentation files (the "Software"), to deal | |
| in the Software without restriction, including without limitation the rights | |
| to use, copy, modify, merge, publish, distribute, sublicense, and/or sell | |
| copies of the Software, and to permit persons to whom the Software is | |
| furnished to do so, subject to the following conditions: |
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.