Development / FIELD GUIDE

CLI, GUI, API. One set of rules.

The interface is a way to perform a task, not a separate permission model. Choose the interaction that makes the work understandable while keeping the same ownership and authorization rules.

Use the GUI for context

A good graphical workflow can show the target, surrounding state, and consequences before a change. Evaluate whether labels distinguish environments and whether destructive actions are clearly separated. A beautiful screen is not a substitute for a correct underlying permission check.

Use the CLI for explicit, repeatable work

Write commands into reviewed procedures with prerequisites, expected results, and a stop condition. Prefer inspection before modification. A copied command still needs to be checked against the actual host, paths, and privileges of the person running it.

Use APIs for bounded automation

Define narrow operations with validated inputs and scoped credentials. Plan timeouts, retries, duplicate prevention, and useful records. An API should not quietly grant an automated process broader authority than a human would receive through the interface.