added scaffolding and ufw setup

README.md

@@ -0,0 +1,52 @@
+# Cachy-workstation
+
+Infrastructure-as-Code for a CachyOS Linux workstation, managed with Ansible.
+
+## Goals
+
+- Describe and reproduce the workstation configuration declaratively
+- Learn Ansible patterns: site-based playbooks, roles, and tags
+
+## Design
+
+- **Tool:** Ansible
+- **Target:** `localhost` only
+- **Entry point:** `site.yml`
+- **Structure:** Roles with tags for selective execution
+
+## Prerequisites
+
+- Ansible installed on the workstation
+- A working Python environment (required by Ansible)
+
+## Usage
+
+Run the full site playbook:
+
+```bash
+ansible-playbook site.yml
+```
+
+Run only tasks matching a specific tag:
+
+```bash
+ansible-playbook site.yml --tags <tagname>
+```
+
+Skip tasks matching a tag:
+
+```bash
+ansible-playbook site.yml --skip-tags <tagname>
+```
+
+## Structure
+
+```
+.
+├── site.yml          # Main entry point
+├── inventory/        # Inventory files
+├── roles/            # Ansible roles
+└── group_vars/       # Variables by group
+```
+
+> Structure will grow as roles are added.