ja
d9392447f9
- Inject all 10 DOX sections into root AGENTS.md (Core Contract, Read Before Editing, Update After Editing, Hierarchy, Child Doc Shape, Style, Closeout, User Preferences, Child DOX Index) - Update ADR 0002: linux612->linux618, 575xx->580xx NVIDIA migration - Update setup.md: kernel/driver refs to current linux618 + 580xx - Update stack.md, hardware-inventory.md: NVIDIA note 595.71->580xx - Update manual-overrides.md: add br_vm_internal bridge deletion entry - Update workstation-health.md: add Recent Cleanup section - Update README.md: current software versions, expand roles list - Add docs/neovim-cheatsheet.md - Bump last_updated to 2026-06-17 on all modified docs
73 lines
2.4 KiB
Markdown
73 lines
2.4 KiB
Markdown
---
|
|
description: >-
|
|
Infrastructure-as-Code and maintenance repository for Michael Wegener's
|
|
primary workstation at satware AG (Pfeddersheim location).
|
|
tags:
|
|
- workstation
|
|
- ansible
|
|
- infrastructure-as-code
|
|
- linux
|
|
- automation
|
|
last_updated: '2026-06-17'
|
|
---
|
|
|
|
# saTway® Infrastructure - mw-pfeddersheim-workstation
|
|
|
|
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:
|
|
|
|
```bash
|
|
# 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
|
|
|
|
# 4. Run daily routine (Morning/EOD)
|
|
bash scripts/daily-routine.sh morning-full
|
|
bash scripts/daily-routine.sh eod
|
|
```
|
|
|
|
## 📂 Project Structure
|
|
|
|
| Directory | Purpose |
|
|
|-----------|---------|
|
|
| `ansible/` | Configuration-as-Code (Roles: `system-upgrade`, `common`, `dev-tools`, `maintenance`, `fonts`, `pdf`, `hyprland`, `greetd`) |
|
|
| `config/` | System configuration templates (`.j2`) |
|
|
| `docs/` | PARA-structured documentation (`product`, `adr`, `learnings`, `tech`, `workflows`, `plans`) |
|
|
| `scripts/` | Maintenance and automation scripts |
|
|
|
|
## 🛠 Software Stack
|
|
|
|
- **Languages**: Node.js 25.6.1, Python 3.14.3, PHP 8.5.3 (CLI)
|
|
- **Automation**: Ansible, Docker
|
|
- **Desktop**: Hyprland (Wayland), greetd + tuigreet, Waybar, Kitty
|
|
- **Kernel**: linux618 (LTS fallback) + linux70 (daily driver)
|
|
- **NVIDIA**: 580xx branch (Pascal/GT 1050 Ti)
|
|
- **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:
|
|
- [Project Brief](docs/product/project-brief.md)
|
|
- [Setup Guide](docs/tech/setup.md)
|
|
- [Software Stack](docs/tech/stack.md)
|
|
- [Software Audit](docs/tech/current-software-audit.md)
|
|
- [Decision Records](docs/adr/0001-use-ansible-for-configuration.md)
|
|
|
|
---
|
|
|
|
© 2026 satware AG. All rights reserved.
|