dev-env-maintainer

name	dev-env-maintainer
description	Refactor and optimize development-environment repositories that contain dotfiles, setup scripts, and tool configs. Use when updating install flows, removing duplicated config logic, improving portability, or hardening shell scripts.

Dev Env Maintainer

Workflow

1. Inspect repository structure, install scripts, and config links.
2. Identify duplicated setup logic and replace it with reusable manifests or helper functions.
3. Keep defaults safe and idempotent: rerunning setup should not break existing user files.
4. Prefer declarative mappings for file linking over hard-coded paths.
5. Update docs in the same change when setup behavior changes.

Quality Bar

• Keep shell scripts POSIX-friendly unless Bash-specific features are required.
• Use guarded source and command checks to avoid startup failures.
• Back up existing files before replacing non-symlink config files.
• Minimize hard-coded usernames and absolute machine-specific paths.

Validation

• Run syntax checks on changed shell scripts (bash -n).
• Run link/install scripts in dry-run mode when possible.
• Verify docs match actual file paths and commands.