infrastructure/mw-pfeddersheim-workstation

Files

T

ja d9392447f9 doxify: inject DOX framework into AGENTS.md and update system config docs

- 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

2026-06-17 14:13:34 +02:00

2.4 KiB

Raw Blame History

description, tags, last_updated

description

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:

# 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:

2.4 KiB Raw Blame History