# SKILL.md

version: 1
project: Uplinkr
maintainer: Sascha Scherhak
license: MIT

---

## Core Expertise

- PHP 8.4
- Laravel 12
- Composer package development
- CLI-first architecture
- File-based JSON storage (MVP phase)
- Global + project-scoped JSON configuration
- Scheduler-driven monitoring workflows
- Heartbeat / "I'm alive" monitoring
- Docker / Podman containerization
- Git & GitHub workflows
- Semantic Versioning (SemVer)
- Open Source maintenance

---

## Architecture Skills

- Modular package design
- Service container architecture
- Configuration-driven systems
- Predictable CLI command behavior
- Explicit runtime behavior
- Event-driven alerting (log, mail, webhook)
- Notification channel design (log, mail, webhook)
- Global settings vs project settings separation
- Extensible probe systems (HTTP, TLS, etc.)
- Async probe execution via queue jobs
- Alert aggregation and cooldown handling
- Clean public API design
- Backward compatibility handling
- Minimal abstraction / minimal magic

---

## Testing & Quality

- PHPUnit
- Orchestra Testbench
- Static code analysis
- PSR-12 compliance
- PHP strict types
- Defensive programming
- Explicit return types
- Small, focused classes
- No hidden side effects

---

## DevOps & Infrastructure

- Docker Compose environments
- Multi-container architecture
- SSL/TLS handling
- Laravel scheduler integration
- Queue worker integration
- CI pipelines (GitHub Actions)
- Branch protection strategies
- Release-based workflow

---

## Release & Workflow Skills

- Changelog maintenance
- Roadmap planning
- Protected branch handling
- Pull Request review discipline
- Conventional commits
- Minor / Patch version classification
- Backwards compatible feature rollout

---

## Collaboration Guardrails

- Explain the plan before making changes
- Keep changes minimal and scoped
- Prefer incremental improvements over rewrites
- Suggest refactorings without auto-applying them
- Ask before architecture or folder refactors
- Ask before renaming namespaces/commands/public classes
- Ask before changing command signatures or CLI output wording
- Ask before adding storage mechanisms (DB/Redis) or new integrations
- Never introduce breaking changes without explicit approval
- Never add frontend dashboards/frameworks
- Never replace file-based storage unless explicitly requested

---

## Optional / Future Skills

- Queue optimization strategies
- Additional probe types beyond HTTP/TLS
- Long-term storage strategy evolution

---

## Soft Skills

- Detail-oriented architecture planning
- Long-term maintainability focus
- Clean documentation culture
- Open Source collaboration mindset
- Structured release communication
- Conservative, explicit engineering mindset