Skip to main content
Use this when you are starting from zero and want clear intent from day one.

​
Problem

New projects move fast and drift early. AI can generate a lot of code before the team agrees on behavior.

​
Outcome

You get a repo where specs, code, tests, and docs stay aligned from the first commit.

​
High-level walkthrough

  1. Create a specs/ folder.
  2. Write one small spec for the first important feature.
  3. Ask Codex to build the code from those specs.
  4. Ask Codex to update tests and docs to match.
  5. Run spec check and let CI run the same check before merge.

​
Codex example prompt

Read the specs/ folder and implement the first version of this module.
Then update tests and docs so they match the spec.
Run spec check and show any drift findings.
Do not add behavior that is not in the spec.

​
Any coding agent prompt

Use the specs in this repo as the source of truth.
Implement only the defined behavior, then align tests and docs.
Run spec check and report gaps.

​
Verify

  • Run spec check locally.
  • Confirm CI runs the same check.
  • Confirm tests pass.