From 783b6f5a7e1f40a7e5ce35b121316c1ac91e4b42 Mon Sep 17 00:00:00 2001
From: Ahmed Abdelhalim <pm@a14m.dev>
Date: Thu, 4 Sep 2025 04:07:01 +0200
Subject: Fix CI

---
 CLAUDE.md | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

(limited to 'CLAUDE.md')

diff --git a/CLAUDE.md b/CLAUDE.md
index 69e13d85..82474d1a 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -22,6 +22,31 @@ ansible-playbook site.yml --ask-become-pass
 ansible all -m ping
 ```
 
+**Run molecule testing:**
+
+```bash
+# Run full test suite for a specific scenario
+molecule test -s archlinux
+molecule test -s ubuntu
+molecule test -s debian
+molecule test -s raspberrypi
+
+# Run specific test phases
+molecule converge -s archlinux    # Run converge only
+molecule idempotence -s archlinux # Run idempotence test only
+molecule verify -s archlinux      # Run verify only
+```
+
+**Debug molecule testing on remote machine:**
+
+```bash
+# Copy to remote machine for debugging
+rsync -r . archlinux.local:/opt/ansible-distro-configure
+
+# Run on remote machine with proper PATH
+ssh archlinux.local "cd /opt/ansible-distro-configure && PATH=~/.local/bin:\$PATH ~/.local/bin/molecule test -s archlinux"
+```
+
 ## Architecture Overview
 
 This is an Ansible configuration management repository for multiple Linux distributions
-- 
cgit v1.2.3