mw-pfeddersheim-workstation/implementation_plan.md

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