better-work

Better Work is a professional execution protocol for AI coding agents. Use when: (1) the task has failed 2+ times or the agent is looping on the same approach; (2) the agent is about to say 'I can't', suggest manual work too early, or blame environment/tooling without verification; (3) the task spans multiple steps, files, or sessions and needs lightweight planning/state tracking; (4) the agent is being passive by not searching, not reading source, not verifying, or waiting for the user to drive; (5) the user signals frustration like 'try again', 'dig deeper', 'verify it', 'make a plan', or similar. Applies to code, debugging, config, deployment, infra, research, APIs, writing, and analysis. Do NOT trigger on first-attempt failures or for tiny one-shot tasks that do not benefit from structure.

Better Work is a professional execution protocol for AI coding agents. Use when: (1) the task has failed 2+ times or the agent is looping on the same approach; (2) the agent is about to say 'I can't', suggest manual work too early, or blame environment/tooling without verification; (3) the task spans multiple steps, files, or sessions and needs lightweight planning/state tracking; (4) the agent is being passive by not searching, not reading source, not verifying, or waiting for the user to drive; (5) the user signals frustration like 'try again', 'dig deeper', 'verify it', 'make a plan', or similar. Applies to code, debugging, config, deployment, infra, research, APIs, writing, and analysis. Do NOT trigger on first-attempt failures or for tiny one-shot tasks that do not benefit from structure.