29 lines
1.4 KiB
Markdown
29 lines
1.4 KiB
Markdown
# 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
|