docs: align with satware AG best practices
- Delete deprecated CLAUDE.md - Create root-level AGENTS.md for AI assistant guidance - Create SDD constitution in .specify/memory/constitution.md - Align documentation with PARA structure (docs/product/project-brief.md, docs/tech/stack.md, docs/plans/) - Add standardized YAML frontmatter to all documentation files - Update README.md with saTway branding and structure
This commit is contained in:
@@ -1,3 +1,13 @@
|
||||
---
|
||||
description: >-
|
||||
Decision to use Ansible for managing workstation configuration and lifecycle.
|
||||
tags:
|
||||
- adr
|
||||
- ansible
|
||||
- configuration-management
|
||||
last_updated: '2026-03-09'
|
||||
---
|
||||
|
||||
# ADR 1: Use Ansible for Workstation Configuration Management
|
||||
|
||||
## Status
|
||||
|
||||
@@ -1,3 +1,14 @@
|
||||
---
|
||||
description: >-
|
||||
Initial setup and baseline verification for the mw-pfeddersheim-workstation
|
||||
infrastructure project.
|
||||
tags:
|
||||
- learning
|
||||
- setup
|
||||
- baseline
|
||||
last_updated: '2026-03-09'
|
||||
---
|
||||
|
||||
# Initial Setup and Baseline - 2026-02-27
|
||||
|
||||
## Context
|
||||
@@ -15,4 +26,4 @@ Starting the formal infrastructure management for the `mw-pfeddersheim-workstati
|
||||
|
||||
## Lessons Learned
|
||||
- Git status confirms all initial files are untracked.
|
||||
- Structure follows PARA for documentation and standard Ansible layout.
|
||||
- Structure follows PARA for documentation and standard Ansible layout.
|
||||
|
||||
@@ -1,7 +1,13 @@
|
||||
---
|
||||
description: Learnings from workstation cleanup and project organization
|
||||
tags: [workstation, cleanup, git, disk-usage]
|
||||
last_updated: 2026-02-27
|
||||
description: >-
|
||||
Learnings from workstation cleanup, disk space optimization, and Git
|
||||
repository organization.
|
||||
tags:
|
||||
- workstation
|
||||
- cleanup
|
||||
- git
|
||||
- disk-usage
|
||||
last_updated: '2026-02-27'
|
||||
---
|
||||
|
||||
# Workstation Organization
|
||||
|
||||
@@ -0,0 +1,42 @@
|
||||
---
|
||||
description: >-
|
||||
Historical implementation plan for the initial baseline of the
|
||||
mw-pfeddersheim-workstation infrastructure.
|
||||
tags:
|
||||
- plan
|
||||
- history
|
||||
- baseline
|
||||
last_updated: '2026-02-27'
|
||||
---
|
||||
|
||||
# Initial Implementation Plan - 2026-02-27
|
||||
|
||||
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.
|
||||
|
||||
## Files & Components
|
||||
|
||||
Updates existing Ansible roles and creates a new learning log for context restoration.
|
||||
|
||||
### 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.
|
||||
|
||||
## 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.
|
||||
@@ -0,0 +1,31 @@
|
||||
---
|
||||
description: >-
|
||||
Immediate next steps and priority tasks for workstation cleanup and repository
|
||||
management.
|
||||
tags:
|
||||
- plan
|
||||
- history
|
||||
- next-steps
|
||||
last_updated: '2026-02-27'
|
||||
---
|
||||
|
||||
# Next Session Tasks - 2026-02-27
|
||||
|
||||
## Priority 1 (Clean Up)
|
||||
- [ ] Address permission issues in `PhpstormProjects/satag-amicron-entity-bundle` and `SatagAmicronSix` to finish removal.
|
||||
- [ ] Decide on the fate of dirty repositories:
|
||||
- `~/Projects/ShopifySyncApp` (New work)
|
||||
- `~/Projects/firebird` (Subrepo modified)
|
||||
- `~/Projects/djh-corporate-identity` (Untracked work)
|
||||
- `~/WebstormProjects/onlyoffice` (Logic changes)
|
||||
|
||||
## Priority 2 (Retention)
|
||||
- [ ] Confirm if repositories without remotes should be uploaded to Gitea/GitLab:
|
||||
- `~/Projects/opus-transcribe`
|
||||
- `~/Projects/20238-MediGruen-Naturprodukte-GmbH`
|
||||
- `~/Projects/any-to-markdown`
|
||||
- `~/Projects/pdf2md`
|
||||
|
||||
## Context
|
||||
- Reclaimed 21GB today by removing clean remote repositories.
|
||||
- Workstation software cleanup is complete and synced to Ansible roles.
|
||||
@@ -1,4 +1,14 @@
|
||||
# mw-pfeddersheim-workstation Infrastructure Overview
|
||||
---
|
||||
description: >-
|
||||
High-level overview and purpose of the mw-pfeddersheim-workstation project.
|
||||
tags:
|
||||
- project-brief
|
||||
- infrastructure
|
||||
- overview
|
||||
last_updated: '2026-03-09'
|
||||
---
|
||||
|
||||
# mw-pfeddersheim-workstation Project Brief
|
||||
|
||||
## Purpose
|
||||
This repository serves as the single source of truth for the configuration and lifecycle management of Michael Wegener's primary workstation at satware AG (Pfeddersheim location).
|
||||
@@ -1,3 +1,15 @@
|
||||
---
|
||||
description: >-
|
||||
Detailed inventory and audit of workstation software, identifying core tools,
|
||||
categorized packages, and candidates for removal.
|
||||
tags:
|
||||
- software-audit
|
||||
- inventory
|
||||
- maintenance
|
||||
- cleanup
|
||||
last_updated: '2026-03-09'
|
||||
---
|
||||
|
||||
# Software Audit - mw-pfeddersheim-workstation (2026-02-27)
|
||||
|
||||
## 1. Core Development Tools
|
||||
|
||||
@@ -1,3 +1,15 @@
|
||||
---
|
||||
description: >-
|
||||
Detailed performance optimization strategies, kernel parameter tuning, and
|
||||
system maintenance routines for the mw-pfeddersheim-workstation.
|
||||
tags:
|
||||
- performance
|
||||
- optimization
|
||||
- kernel-tuning
|
||||
- maintenance
|
||||
last_updated: '2026-03-09'
|
||||
---
|
||||
|
||||
# mw-pfeddersheim-workstation Performance Tuning
|
||||
|
||||
## Overview
|
||||
|
||||
+11
-1
@@ -1,3 +1,13 @@
|
||||
---
|
||||
description: >-
|
||||
Workstation bootstrapping and setup instructions using Ansible.
|
||||
tags:
|
||||
- setup
|
||||
- bootstrap
|
||||
- ansible
|
||||
last_updated: '2026-03-09'
|
||||
---
|
||||
|
||||
# Workstation Setup Guide
|
||||
|
||||
This guide describes how to bootstrap the **mw-pfeddersheim-workstation** infrastructure on a fresh installation.
|
||||
@@ -13,7 +23,7 @@ This guide describes how to bootstrap the **mw-pfeddersheim-workstation** infras
|
||||
```bash
|
||||
mkdir -p ~/infrastructure
|
||||
cd ~/infrastructure
|
||||
git clone <repo-url> mw-pfeddersheim-workstation
|
||||
git clone https://git.satware.ai/infrastructure/mw-pfeddersheim-workstation.git
|
||||
cd mw-pfeddersheim-workstation
|
||||
```
|
||||
|
||||
|
||||
@@ -1,3 +1,14 @@
|
||||
---
|
||||
description: >-
|
||||
Detailed inventory of the core software stack, OS context, and maintenance
|
||||
policies for the mw-pfeddersheim-workstation.
|
||||
tags:
|
||||
- software-stack
|
||||
- inventory
|
||||
- tech-stack
|
||||
last_updated: '2026-03-09'
|
||||
---
|
||||
|
||||
# Software Stack - mw-pfeddersheim-workstation
|
||||
|
||||
## Core Development Environment
|
||||
@@ -1,7 +1,13 @@
|
||||
---
|
||||
description: Workstation health and specification baseline
|
||||
tags: [infrastructure, health-check, workstation]
|
||||
last_updated: 2026-03-06
|
||||
description: >-
|
||||
Comprehensive health report for the mw-pfeddersheim-workstation, including
|
||||
system specifications, current status, and runtime environment details.
|
||||
tags:
|
||||
- infrastructure
|
||||
- health-check
|
||||
- workstation
|
||||
- monitoring
|
||||
last_updated: '2026-03-09'
|
||||
---
|
||||
|
||||
# Workstation Health Report: mw-manjaro-pf
|
||||
@@ -13,7 +19,7 @@ last_updated: 2026-03-06
|
||||
- **Secondary Disk**: 500 GB SATA SSD (Samsung 840 EVO) -> `/home/mw/models`
|
||||
- **OS**: Manjaro Linux (Kernel 6.12)
|
||||
|
||||
## Current Health Status (2026-03-06)
|
||||
## Current Health Status (2026-03-09)
|
||||
- **Disk Usage (/)**: 75% (333G used, 113G free)
|
||||
- **Maintenance**:
|
||||
- Orphaned packages cleaned (ninja, texlive components, etc.)
|
||||
|
||||
Reference in New Issue
Block a user