Ansible Role Writing

Follow the conventions in ~/dotfiles/stapler-scripts/roles/CLAUDE.md for all role work in this repo. This skill layers actionable process on top of those conventions.

Before Writing Anything

1. Read the existing role if extending one — check defaults/, vars/, handlers/ before adding anything
2. Check requirements.yml for available collections — don't re-implement what a collection already provides
3. Check ansible.cfg — roles_path = roles means role names resolve relative to stapler-scripts/

Starting a New Role

Scaffold (only create dirs you'll use)

mkdir -p stapler-scripts/roles/<name>/{tasks,handlers,defaults}