Cursor/Codex-Ready Brief Template for Faster MVP Execution

A strong implementation brief is constraint-first. Put non-negotiables and acceptance criteria before optional enhancements.

Goal:
Deliver X feature end-to-end with tests.

Constraints:
- No new dependencies.
- Keep current API contract stable.
- Mobile layout must not overflow.

Acceptance criteria:
- Scenario A passes.
- Scenario B passes.
- npm run lint && npm run test && npm run build pass.

Coding models produce better results when scope, files, and failure handling are explicit. Avoid generic prompts and include concrete file targets.

• Name exact files and route handlers to edit.
• Define what must not change (network logic, schemas, contracts).
• Ask for minimal diffs and final verification commands.

Run in short loops: implement, test, inspect UX, then patch. Keep prompts deterministic and avoid asking for full rewrites.

• Loop 1: Build the smallest working version.
• Loop 2: Fix edge cases and accessibility.
• Loop 3: Add tests that lock behavior.
• Loop 4: Polish copy and ship.

Use this checklist before merging any AI-assisted implementation work.

• Diff is minimal and reversible.
• No secrets in logs or fixtures.
• No new runtime calls on passive actions.
• Routes are indexable and canonical tags are correct.