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