From 95cae3313f603ba3b07b8102dee641555e2e40bc Mon Sep 17 00:00:00 2001
From: NomakCooper <marco.X0178421@gmail.com>
Date: Wed, 1 Apr 2026 23:52:38 +0200
Subject: [PATCH] update README.md file

---
 README.md | 72 +++++++++++++++++++++++++++++++++++++++++++++----------
 1 file changed, 60 insertions(+), 12 deletions(-)

diff --git a/README.md b/README.md
index 3200515..e1e6723 100644
--- a/README.md
+++ b/README.md
@@ -11,7 +11,7 @@
  ▐▛███▜▌   Claude Code
 ▝▜█████▛▘  Sonnet 4.6 · Claude
   ▘▘ ▝▝    ansible-designer/
-  ⎿  SessionStart:startup says: [ansible-designer]
+  ⎿  SessionStart:startup says: [ansible-designer 0.1.5]
      ──────────────────────────────────────────────────────────
 
  █████╗ ███╗   ██╗███████╗██╗██████╗ ██╗     ███████╗         
@@ -44,20 +44,16 @@ AI-assisted Ansible authoring toolkit for Claude Code. Scaffolds, reviews, and u
 Using Claude Code:
 
 ```bash
-───────────────────────────────────────────────────────────────
-❯ /plugin marketplace add 3A2DEV/ansible-designer
-───────────────────────────────────────────────────────────────
+/plugin marketplace add 3A2DEV/ansible-designer
 ```
 ```bash
-───────────────────────────────────────────────────────────────
-❯ /plugin install ansible-designer
-───────────────────────────────────────────────────────────────
+/plugin install ansible-designer
 ```
 
 ### Option B — npx skills (bare install, sub-commands not namespaced)
 
 ```bash
-npx skills add 3A2DEV/ansible-designer -a claude-code --skill '*'
+npx skills add 3A2DEV/ansible-designer --skill '*'
 ```
 
 > **Note:** This installs each skill as a top-level command (e.g. `/review-playbook`) without the `ansible-designer:` namespace. Use Option A for the full `/ansible-designer:review-playbook` experience.
@@ -132,19 +128,19 @@ Every command enforces these rules:
 
 ### Create a new role for nginx with RHEL + Solaris support
 
-```
+```bash
 /ansible-designer:new-role
 
 > Role name: nginx
 > Location: ./roles/
-> Multi-OS support: yes (RHEL + Solaris)
+> Multi-OS support: yes
 
 → Generates roles/nginx/ with 12 files including OS-specific task and var files
 ```
 
 ### Review an existing playbook
 
-```
+```bash
 /ansible-designer:review-playbook deploy-app.yml
 
 ## Playbook Review: deploy-app.yml
@@ -161,7 +157,7 @@ Every command enforces these rules:
 
 ### Generate an AWX-optimized ansible.cfg
 
-```
+```bash
 /ansible-designer:new-conf
 
 > Environment: awx
@@ -170,6 +166,58 @@ Every command enforces these rules:
   strict SSH settings, and annotated vault identity list
 ```
 
+### Update ansible.cfg with credential-safe diff display
+
+```bash
+/ansible-designer:update-conf
+
+> Change: enable fact caching with redis
+
+⚠ Warning: 1 line(s) with credential-like values were redacted from this display.
+  Review the file directly before applying changes.
+
+--- ansible.cfg (original)
++++ ansible.cfg (proposed)
+@@ -8,6 +8,10 @@
+ forks                 = 10
+ timeout               = 30
++
++# Fact caching: redis (shared across controller nodes; configure auth via REDIS_URL or vault)
++fact_caching          = redis
++fact_caching_connection = redis://:{{ vault_redis_password }}@cache.internal:6379/0
++fact_caching_timeout  = 86400
+
+Apply this change? (yes/no)
+```
+
+### Scaffold a new collection with input validation
+
+```bash
+/ansible-designer:new-collection
+
+> collection_path: ./collections/ansible_collections/
+> namespace: myorg
+> collection_name: security_baseline
+> description: Baseline security hardening collection for RHEL targets
+> author: ops-team <ops@example.com>
+
+Will create: ./collections/ansible_collections/myorg/security_baseline/ (13 files)
+
+  galaxy.yml            — namespace: myorg, name: security_baseline, version: 0.1.0
+  README.md             — collection overview
+  CHANGELOG.md          — v0.1.0 initial
+  LICENSE               — Apache 2.0
+  meta/runtime.yml      — requires_ansible: >=2.15.0
+  plugins/modules/get_info.py
+  plugins/filter/string_filters.py
+  plugins/lookup/config_value.py
+  roles/.gitkeep
+  tests/integration/.gitkeep
+  tests/unit/.gitkeep
+
+Proceed? (yes/no)
+```
+
 ---
 
 ## Examples