bettercodex-plugins

Reproduce a bug with a failing test before fixing it, so the fix is proven and can't silently regress. Use when the user reports a bug, says "this is broken", "X returns the wrong value", "fix this crash", or hands over a stack trace or a failing case. Write the smallest test that fails for the stated reason, then fix until it passes — and only it changes from red to green.

Turn a messy working tree into clean, reviewable commits and a tight PR description. Use when the user says "open a PR", "commit this", "clean up my commits", "get this ready to push/review", or when a dirty tree mixes unrelated changes. Splits work into one logical change per commit, writes conventional messages, and drafts a PR body grounded in the actual diff.

Orient yourself in an unfamiliar repository before doing any work. Use when you open a new project, clone a repo, switch into a codebase you don't know, or ask "how do I run this / where do I start / how is this project set up". Produces a concrete first-run checklist (install, build, test, run) and a short map of the codebase, grounded in the project's own files — never guessed.

Capture a compact, resume-ready checkpoint of the current Codex session so work survives a long thread, a context reset, or a handoff. Use when the conversation is getting long, before switching tasks, when the user says "checkpoint", "save where we are", "summarize so we can continue later", or "hand this off". Writes a durable status note — not chat fluff — that the next session can act on cold.