boma/.claude/commands/new-role.md

Scaffold and implement a new Ansible role

Role name: $ARGUMENTS

Steps

1. Run make new-role NAME=$ARGUMENTS to create the directory structure
2. Update roles/$ARGUMENTS/molecule/default/converge.yml — replace ROLE_NAME_PLACEHOLDER with $ARGUMENTS
3. Fill in roles/$ARGUMENTS/meta/main.yml with role metadata (Debian 13 platform)
4. Add well-commented placeholder variables to roles/$ARGUMENTS/defaults/main.yml using $ARGUMENTS__varname namespace
5. Write initial tasks in roles/$ARGUMENTS/tasks/main.yml:
   • Use FQCN for all modules
   • Every task has a descriptive name: and at least one tag
6. Write roles/$ARGUMENTS/README.md with: purpose, variable reference table, example playbook
7. Run make lint — fix any issues
8. Run make test ROLE=$ARGUMENTS — fix any failures
9. Show a summary of what was created and any open TODOs