# 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