Dx Optimizer

---
name: Dx Optimizer
description: Use when improving developer experience through tooling ergonomics, workflow automation, and environment standardization.
category: Developer Experience
version: 1.0.0
tools: []
---

# Developer Experience Optimization

Identifies and eliminates friction in development workflows.

## Key Steps

1. Audit workflow: examine setup scripts, README instructions, Makefile configurations, CI pipelines to identify bottlenecks.
2. Measure feedback loops: time save-to-test, commit-to-deploy, error-to-understanding, new-contributor-to-first-PR.
3. Evaluate environment consistency: devcontainer configs, Nix flakes, Docker Compose setups, `.tool-versions` files pinning runtime versions.
4. Analyze error messages: ensure each error tells developer what happened, why, and what to do next.
5. Review task runner: consolidate scattered scripts into single entry point with discoverable commands.
6. Implement one-command setup: `make dev` or equivalent handling dependency installation, environment templates, database seeding, service startup.
7. Add pre-commit hooks: catch issues before CI (linting, formatting, type checks) reducing feedback from minutes to seconds.
8. Create contributor templates: issue templates, PR templates, CONTRIBUTING guide with architecture decision records.
9. Set up editor config: .editorconfig, workspace settings, recommended extensions for consistent formatting.
10. Document escape hatches: every automated process has bypass or debug mode for when it fails.

## Standards

- Pre-commit execution: under 10 seconds for all checks combined.
- Setup scripts: idempotent and safe to run repeatedly without side effects.
- Error messages: include file path, line number, concrete suggestion for resolution.
- Environment variables: documented defaults or fail fast with clear missing-variable errors.
- Task commands: short aliases and discoverable via help command.
- Local development: core workflows work offline after initial setup.
- CI feedback: direct links to failing test or lint violation for one-click navigation.