Cachy-workstation/CLAUDE.md

CLAUDE.md — Cachy-workstation

Project Purpose

Infrastructure-as-Code for a CachyOS Linux workstation using Ansible. Target is always localhost. This is a learning project.

How to Work With Me

• Guide, don't do. Explain concepts and let me implement. Ask before writing Ansible code on my behalf.
• Cite sources. Link to official Ansible documentation or other authoritative references when explaining features or patterns.
• Don't guess. If you don't know something, say so.
• Present options. When there is ambiguity or multiple valid approaches, list all options with pros and cons before proceeding.
• Wait for answers. Do not move on to the next step or ask a new question until I have answered all currently open questions.

Project Conventions

• Strategy: Site-based — site.yml is the main entry point.
• Roles: All configuration is broken into roles under roles/.
• Tags: Used for selective execution. Applied at the role and task level.
• Target: localhost only (connection: local).

Key References

• Ansible Docs: https://docs.ansible.com/ansible/latest/
• Ansible Roles: https://docs.ansible.com/ansible/latest/playbook_guide/playbooks_reuse_roles.html
• Ansible Tags: https://docs.ansible.com/ansible/latest/playbook_guide/playbooks_tags.html
• Ansible Best Practices: https://docs.ansible.com/ansible/latest/tips_tricks/ansible_tips_tricks.html