| name | developer-tooling |
| description | Build developer tooling that turns a repeated engineering workflow into a fast, safe, discoverable, scriptable, and diagnosable interface. |
Developer Tooling
Use for CLIs, code generators, local dev tools, linters, repository automation, and engineering utilities.
Procedure
- Observe the actual workflow and identify repeated friction, unsafe manual steps, or missing feedback.
- Define the primary user and the smallest command/interface that removes that friction.
- Make defaults safe and common usage obvious; expose advanced control without forcing it on every user.
- Design stable input/output and exit behavior so the tool can be scripted and composed.
- Provide actionable error messages with enough context to recover.
- Avoid destructive behavior without explicit intent, previews, backups, or idempotent semantics where appropriate.
- Test across representative environments and failure cases.
- Document installation, examples, and troubleshooting close to the tool.
Quality gate
The tool should reduce cognitive and operational load. A wrapper that merely hides errors or adds another mandatory step is not an improvement.