35 lines
1.3 KiB
Markdown
35 lines
1.3 KiB
Markdown
# CLAUDE.md - mw-pfeddersheim-workstation Infrastructure
|
|
|
|
## Project Overview
|
|
This repository manages the DevOps configuration, software stack, and maintenance scripts for the **mw-pfeddersheim-workstation**. It follows the **saTway** methodology for workstations.
|
|
|
|
## Key Directories
|
|
- `docs/`: Documentation (Product, Tech, ADR, Learnings)
|
|
- `scripts/`: Maintenance and automation scripts
|
|
- `config/`: System and application configurations
|
|
- `ansible/`: Provisioning and configuration management
|
|
- `.clinerules/`: Project-specific AI behavior rules
|
|
|
|
## Essential Commands
|
|
| Command | Purpose |
|
|
|---------|---------|
|
|
| `bash scripts/maintenance.sh` | Run standard system maintenance |
|
|
| `bash scripts/backup.sh` | Trigger local backup routines |
|
|
| `ansible-playbook ansible/workstation.yml` | Apply workstation configuration |
|
|
|
|
## Standards
|
|
- **Methodology**: Baby Steps™, TDD for scripts
|
|
- **Security**: Zero-Trust, Gitleaks for secrets
|
|
- **Documentation**: All changes documented in `docs/`
|
|
- **Scripting**: Bash scripts must use `set -euo pipefail`
|
|
|
|
## Guardrails
|
|
- **NEVER** commit secrets or private keys
|
|
- **ALWAYS** test scripts in a safe manner before full execution
|
|
- **PREFER** Ansible for system-wide configuration changes
|
|
|
|
## Rules Hierarchy
|
|
1. `Rules/` (Global satware AG policies)
|
|
2. `.clinerules/` (Project-specific workstation rules)
|
|
3. `CLAUDE.md` (This file)
|