added scaffolding and ufw setup

2026-06-19 11:56:51 -05:00
commit 17d19d8daa
6 changed files with 126 additions and 0 deletions
@@ -0,0 +1,28 @@
+# 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