This repository manages the configuration, software stack, and maintenance scripts for Michael Wegener's primary workstation. It ensures a reproducible, secure, and optimized environment following satware AG best practices.

🚀 Quick Start

To apply the current configuration or run maintenance:

# 1. Verify configuration with a dry run
ansible-playbook ansible/workstation.yml --check

# 2. Apply configuration locally
ansible-playbook ansible/workstation.yml

# 3. Run automated maintenance
bash scripts/maintenance.sh

📂 Project Structure

Directory	Purpose
`ansible/`	Configuration-as-Code (Roles: `common`, `dev-tools`, `maintenance`)
`config/`	System configuration templates (`.j2`)
`docs/`	PARA-structured documentation (`product`, `adr`, `learnings`, `tech`)
`scripts/`	Maintenance and automation scripts

🛠 Software Stack

Languages: Node.js 22 LTS, Python 3.12+, PHP 8.4
Automation: Ansible, Docker
Environment: Manjaro/Arch Linux, Bash

📜 Core Principles

Baby Steps™: All changes are small, atomic, and verifiable.
Spec-Driven Development: Intent-first development with explicit documentation.
Zero-Trust: Secrets are managed via ansible-vault or environment variables; never committed raw.

📄 Documentation

Comprehensive documentation is available in the docs/ directory: