A command that stops for human review can look like a failure if you read only the process exit code. The durable fix is to classify structured outcomes deliberately, preserve evidence on every path, and assign exactly one owner for failure output.

The problem

The symptom was familiar: an interact...

When a worker occasionally returns malformed Markdown, the visible bug looks like a formatting mistake. It usually is not. The durable fix is to align the worker prompt, canonical grammar, parser, writer, diagnostics, and documentation as one contract family—and to classify every rejection with a de...

When an operator types a repository path and the system disagrees about spelling, the visible bug looks like a casing or formatting problem. It usually is not. The durable fix is to reconcile Git's registered worktree identity against the filesystem object identity at the shared authority boundary —...

A lifecycle entry command is where operators first touch a governed workflow. When it fails late — after scaffolding work has started, or after a missing worker CLI is only discovered at dispatch — the failure feels like a bug in the tool. It is often a boundary problem.

The fix is not simply "chec...

Shortcut routes can make governed workflows easier to operate, but they are risky when the route name hides which stages, audits, and artifacts actually exist. A reduced path still needs a complete contract.

Opening

Shortcut paths are useful until they become ambiguous.

In a governed workflow, a ...