3A2DEV

ansible-designer

 ▐▛███▜▌   Claude Code
▝▜█████▛▘  Sonnet 4.6 · Claude
  ▘▘ ▝▝    ansible-designer/
  ⎿  SessionStart:startup says: [ansible-designer 0.1.7]
     ──────────────────────────────────────────────────────────

 █████╗ ███╗   ██╗███████╗██╗██████╗ ██╗     ███████╗         
██╔══██╗████╗  ██║██╔════╝██║██╔══██╗██║     ██╔════╝         
███████║██╔██╗ ██║███████╗██║██████╔╝██║     █████╗           
██╔══██║██║╚██╗██║╚════██║██║██╔══██╗██║     ██╔══╝           
██║  ██║██║ ╚████║███████║██║██████╔╝███████╗███████╗         
╚═╝  ╚═╝╚═╝  ╚═══╝╚══════╝╚═╝╚═════╝ ╚══════╝╚══════╝         
                                                              
██████╗ ███████╗███████╗██╗ ██████╗ ███╗   ██╗███████╗██████╗ 
██╔══██╗██╔════╝██╔════╝██║██╔════╝ ████╗  ██║██╔════╝██╔══██╗
██║  ██║█████╗  ███████╗██║██║  ███╗██╔██╗ ██║█████╗  ██████╔╝
██║  ██║██╔══╝  ╚════██║██║██║   ██║██║╚██╗██║██╔══╝  ██╔══██╗
██████╔╝███████╗███████║██║╚██████╔╝██║ ╚████║███████╗██║  ██║
╚═════╝ ╚══════╝╚══════╝╚═╝ ╚═════╝ ╚═╝  ╚═══╝╚══════╝╚═╝  ╚═╝

───────────────────────────────────────────────────────────────
❯ /ansible-designer
───────────────────────────────────────────────────────────────

AI-assisted Ansible authoring toolkit for Claude Code. Scaffolds, reviews, and updates playbooks, roles, collections, and ansible.cfg files following ansible-core 2.15+ conventions and production best practices.

---

Installation

Option A — Claude Code plugin system (recommended)

Using Claude Code:

/plugin marketplace add 3A2DEV/ansible-designer

/plugin install ansible-designer

Option B — npx skills CLI

npx skills add 3A2DEV/ansible-designer --skill '*'

Both options register each skill as a top-level command (e.g. /new-playbook, /review-role).

Requirements:

• Claude Code
• No additional dependencies — all Ansible knowledge is embedded in the skill

---

Available Commands

Command	Description
/ansible-designer	Show this overview and available commands
Playbooks
/new-playbook	Create a new playbook (site, component, or AWX-ready)
/review-playbook	Review a playbook — severity report, no file modification
/update-playbook	Update a playbook — diff + confirm before writing
Roles
/new-role	Scaffold a complete role (asks about multi-OS support)
/review-role	Review a role — severity report, no file modification
/update-role	Update a role — diff + confirm before writing
Collections
/new-collection	Scaffold a new collection with galaxy.yml, plugins, roles
/review-collection	Review a collection — severity report, no file modification
/update-collection	Update a collection — diff + confirm before writing
ansible.cfg
/new-conf	Generate annotated ansible.cfg for dev, CI, or AWX
/review-conf	Review ansible.cfg — severity report, no file modification
/update-conf	Update ansible.cfg — diff + confirm before writing

---

How Discovery Works

Every command begins by scanning the project for context:

CLAUDE.md → ansible.cfg → README.md → filesystem scan

Discovery extracts:

• roles_path — where roles live
• collections_paths — where collections live
• Existing roles and collections (for FQCN suggestions)
• Inventory location
• Vault configuration
• Namespace hints

This context is used to suggest smart defaults, resolve FQCNs, and skip questions the user doesn't need to answer.

---

Global Rules

Every command enforces these rules:

1. FQCN everywhere — ansible.builtin.copy, never copy
2. Tags on every task — component name + action category (install, configure, service, validate)
3. no_log: true on secrets — mandatory on tasks handling passwords, tokens, vault variables
4. Never overwrite silently — every write shows a summary or diff first, then waits for confirmation
5. review never modifies — review commands produce reports only
6. update always diffs — update commands show unified diffs before writing
7. File tree after writes — every write operation ends with a file tree
8. Testing-aware output — generated examples and updates include a realistic validation path
9. Next step suggestion — every command ends with a concrete next action

---

Example Usage