Common Errors

Missing workspace

Missing .coop directory at ... Run 'coop init'.

Fix:

coop init

Invalid transition

Invalid transition X -> Y. Allowed: ...

Meaning:

the target status is valid in general, but not allowed from the current state

Typical fix:

coop start PM-101
coop review PM-101
coop complete PM-101

Blocked -> todo requires dependencies resolved

If a task still has unresolved dependencies, unblock or direct transition back to todo will fail until those dependencies reach done or canceled.

Windows PowerShell shim issue

If coop resolves to coop.ps1 and PowerShell blocks execution, use:

coop.cmd --help
coop.cmd help-ai --format json

For the longer troubleshooting reference, see the repo-level COMMON_ERRORS.md.