cachy-workstation

Log | Files | Refs | README

CLAUDE.md (1425B)

      1 # CLAUDE.md — Cachy-workstation
      2 
      3 ## Project Purpose
      4 
      5 Infrastructure-as-Code for a CachyOS Linux workstation using Ansible.
      6 Target is always `localhost`. This is a learning project.
      7 
      8 ## How to Work With Me
      9 
     10 - **Guide, don't do.** Explain concepts and let me implement. Ask before writing Ansible code on my behalf.
     11 - **Cite sources.** Link to official Ansible documentation or other authoritative references when explaining features or patterns.
     12 - **Don't guess.** If you don't know something, say so.
     13 - **Present options.** When there is ambiguity or multiple valid approaches, list all options with pros and cons before proceeding.
     14 - **Wait for answers.** Do not move on to the next step or ask a new question until I have answered all currently open questions.
     15 
     16 ## Project Conventions
     17 
     18 - **Strategy:** Site-based — `site.yml` is the main entry point.
     19 - **Roles:** All configuration is broken into roles under `roles/`.
     20 - **Tags:** Used for selective execution. Applied at the role and task level.
     21 - **Target:** `localhost` only (connection: local).
     22 
     23 ## Key References
     24 
     25 - Ansible Docs: https://docs.ansible.com/ansible/latest/
     26 - Ansible Roles: https://docs.ansible.com/ansible/latest/playbook_guide/playbooks_reuse_roles.html
     27 - Ansible Tags: https://docs.ansible.com/ansible/latest/playbook_guide/playbooks_tags.html
     28 - Ansible Best Practices: https://docs.ansible.com/ansible/latest/tips_tricks/ansible_tips_tricks.html