feat: initial infrastructure baseline

implementation_plan.md

@@ -0,0 +1,51 @@
+# Implementation Plan
+
+Establish a stable infrastructure baseline for the mw-pfeddersheim-workstation by committing existing files, implementing missing Ansible tasks, and cleaning up legacy tool remnants.
+
+This plan focuses on transition the repository from an uncommitted state to a managed baseline. It addresses the user's specific request to remove VS Code remnants and local AI tools while setting up a robust maintenance routine through Ansible and shell scripts. The goal is to ensure Michael Wegener's workstation is reproducible and follows the defined saTway standards.
+
+[Types]
+No custom type system changes are required for this infrastructure-heavy task.
+
+[Files]
+Updates existing Ansible roles and creates a new learning log for context restoration.
+
+Detailed breakdown:
+- New files:
+    - `docs/learnings/2026-02-27-initial-setup.md`: Documentation of the initial repository state and first baseline.
+    - `ansible/roles/maintenance/tasks/main.yml`: Implementation of system cleanup and maintenance tasks.
+    - `ansible/roles/dev-tools/tasks/main.yml`: Implementation of development tool management (installation of core tools, removal of legacy ones).
+- Existing files to be modified:
+    - `scripts/maintenance.sh`: Enhanced to handle the `--check` flag and integrate better with Ansible-driven cleanup.
+- Configuration updates:
+    - `.gitignore`: Ensure all relevant system and Ansible files are correctly tracked or ignored.
+
+[Functions]
+No software functions are being implemented; focus is on shell script logic and Ansible tasks.
+
+Detailed breakdown:
+- Modified scripts:
+    - `scripts/maintenance.sh`: Add parameter parsing for `--check` and implement non-destructive validation mode.
+
+[Classes]
+No classes are used in this project.
+
+[Dependencies]
+Ansible 10.x and standard Arch Linux packages (paccache, checkupdates, journalctl).
+
+[Implementation Order]
+The sequence is designed to establish a git baseline before making system-level changes.
+
+1. Create initial learning log for documentation.
+2. Perform initial git commit of all untracked infrastructure files.
+3. Create `feat/initial-baseline` branch for subsequent changes.
+4. Implement `ansible/roles/maintenance/tasks/main.yml` including VS Code and AI tool cleanup.
+5. Implement `ansible/roles/dev-tools/tasks/main.yml` for core tool validation.
+6. Update `scripts/maintenance.sh` to support `--check` mode.
+7. Execute Ansible playbook in check mode, then apply.
+
+task_progress Items:
+- [ ] Step 1: Document initial state and create baseline commit
+- [ ] Step 2: Implement maintenance role with cleanup tasks (VS Code, AI tools)
+- [ ] Step 3: Implement dev-tools role for core workstation software
+- [ ] Step 4: Enhance maintenance script and verify via Ansible check mode