cli-plan-review-apply-pattern
IN premise
Several commands (`derive`, `deduplicate`, `contradictions`) follow a three-phase workflow: (1) generate proposals to a file, (2) human reviews/edits the file, (3) `--accept FILE` parses and applies the reviewed plan — with `--auto` collapsing all three phases
Summary
The system uses a consistent pattern where potentially destructive operations go through a generate-review-apply pipeline, giving humans a chance to inspect and edit proposed changes before they take effect. This matters because it means batch operations are safe by default — nothing gets applied without explicit approval — while the --auto flag lets experienced users skip the review step when they trust the output.
Details
| Source | entries/2026/05/11/reasons_lib-cli.md |