DeployerPHP (Debugger Tier)
Use this skill to diagnose problems without changing infrastructure.
Execution Protocol
- Run commands in non-interactive form with explicit options.
- Read inventory before diagnostics.
- Use only safe, read-only remote shell commands through
server:run.
- Never run interactive terminal commands (
less, top, vim, nano, REPL tools).
- If a fix requires mutation, stop and propose an admin-tier command.
Required Context
Set concrete values before running commands:
PROJECT_ROOT="/path/to/project"
ENV_FILE="$PROJECT_ROOT/.env"
INVENTORY_FILE="$PROJECT_ROOT/.deployer/inventory.yml"
SERVER="production"
SITE="example.com"
PHP_SERVICE="php8.3-fpm"
References
- Inventory schema:
.deployer/inventory.yml
- Command catalog:
deployer list --raw
- Command reference:
deployer help server:info
- Command reference:
deployer help server:logs
- Command reference:
deployer help server:run
Non-Interactive Command Reference
| Command |
Reference |
Complete non-interactive example |
server:info |
deployer help server:info |
deployer server:info --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" |
server:logs (service scope) |
deployer help server:logs |
deployer server:logs --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --service="nginx,$PHP_SERVICE" --lines=200 |
server:logs (site scope) |
deployer help server:logs |
deployer server:logs --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --site="$SITE" --lines=200 |
server:run (command wrapper) |
deployer help server:run |
deployer server:run --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --command="<SAFE_READ_ONLY_COMMAND>" |
Safe server:run Command Reference
Run these exactly through server:run:
# Release + symlink inspection
deployer server:run --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --command="ls -la /home/deployer/$SITE/releases"
deployer server:run --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --command="readlink /home/deployer/$SITE/current"
# Service status (read-only)
deployer server:run --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --command="systemctl status nginx --no-pager"
deployer server:run --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --command="systemctl status $PHP_SERVICE --no-pager"
# Capacity + runtime
deployer server:run --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --command="df -h"
deployer server:run --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --command="free -h"
deployer server:run --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --command="uptime"
deployer server:run --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --command="ss -tuln"
# Logs + app files
deployer server:run --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --command="tail -n 200 /home/deployer/$SITE/shared/storage/logs/laravel.log"
deployer server:run --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --command="ls -la /home/deployer/$SITE/shared/.env"
# Process and PHP diagnostics
deployer server:run --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --command="ps aux | grep php"
deployer server:run --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --command="php -v"
deployer server:run --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --command="php -i | grep memory_limit"
Forbidden Commands In Debugger Tier
- Any command that changes state: deploy, install, create, delete, sync, start, stop, restart
- Destructive shell commands:
rm, mv, cp, chmod, chown, kill, reboot, package managers
- Interactive terminal commands:
less, top, htop, vim, nano, nested ssh
Standard Debug Workflow
- Read
.deployer/inventory.yml.
- Run
server:info.
- Run targeted
server:logs.
- Run safe
server:run diagnostics.
- Report root-cause hypothesis, evidence, and exact admin-tier command required for remediation.
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1---2name: deployerphp-debugger3description: Read-focused DeployerPHP debugger for production triage. Use when an agent must inspect inventory, logs, service status, and filesystem/runtime state via non-interactive commands without changing infrastructure. Supports `server:info`, `server:logs`, and safe `server:run` diagnostics only. Use when this capability is needed.4---56# DeployerPHP (Debugger Tier)78Use this skill to diagnose problems without changing infrastructure.910## Execution Protocol11121. Run commands in non-interactive form with explicit options.132. Read inventory before diagnostics.143. Use only safe, read-only remote shell commands through `server:run`.154. Never run interactive terminal commands (`less`, `top`, `vim`, `nano`, REPL tools).165. If a fix requires mutation, stop and propose an admin-tier command.1718## Required Context1920Set concrete values before running commands:2122```bash23PROJECT_ROOT="/path/to/project"24ENV_FILE="$PROJECT_ROOT/.env"25INVENTORY_FILE="$PROJECT_ROOT/.deployer/inventory.yml"26SERVER="production"27SITE="example.com"28PHP_SERVICE="php8.3-fpm"29```3031## References3233- Inventory schema: `.deployer/inventory.yml`34- Command catalog: `deployer list --raw`35- Command reference: `deployer help server:info`36- Command reference: `deployer help server:logs`37- Command reference: `deployer help server:run`3839## Non-Interactive Command Reference4041| Command | Reference | Complete non-interactive example |42| ------------------------------ | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |43| `server:info` | `deployer help server:info` | `deployer server:info --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER"` |44| `server:logs` (service scope) | `deployer help server:logs` | `deployer server:logs --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --service="nginx,$PHP_SERVICE" --lines=200` |45| `server:logs` (site scope) | `deployer help server:logs` | `deployer server:logs --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --site="$SITE" --lines=200` |46| `server:run` (command wrapper) | `deployer help server:run` | `deployer server:run --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --command="<SAFE_READ_ONLY_COMMAND>"` |4748## Safe `server:run` Command Reference4950Run these exactly through `server:run`:5152```bash53# Release + symlink inspection54deployer server:run --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --command="ls -la /home/deployer/$SITE/releases"55deployer server:run --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --command="readlink /home/deployer/$SITE/current"5657# Service status (read-only)58deployer server:run --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --command="systemctl status nginx --no-pager"59deployer server:run --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --command="systemctl status $PHP_SERVICE --no-pager"6061# Capacity + runtime62deployer server:run --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --command="df -h"63deployer server:run --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --command="free -h"64deployer server:run --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --command="uptime"65deployer server:run --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --command="ss -tuln"6667# Logs + app files68deployer server:run --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --command="tail -n 200 /home/deployer/$SITE/shared/storage/logs/laravel.log"69deployer server:run --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --command="ls -la /home/deployer/$SITE/shared/.env"7071# Process and PHP diagnostics72deployer server:run --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --command="ps aux | grep php"73deployer server:run --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --command="php -v"74deployer server:run --env="$ENV_FILE" --inventory="$INVENTORY_FILE" --server="$SERVER" --command="php -i | grep memory_limit"75```7677## Forbidden Commands In Debugger Tier7879- Any command that changes state: deploy, install, create, delete, sync, start, stop, restart80- Destructive shell commands: `rm`, `mv`, `cp`, `chmod`, `chown`, `kill`, `reboot`, package managers81- Interactive terminal commands: `less`, `top`, `htop`, `vim`, `nano`, nested `ssh`8283## Standard Debug Workflow84851. Read `.deployer/inventory.yml`.862. Run `server:info`.873. Run targeted `server:logs`.884. Run safe `server:run` diagnostics.895. Report root-cause hypothesis, evidence, and exact admin-tier command required for remediation.9091---92> Converted and distributed by [TomeVault](https://tomevault.io/claim/loadinglucian) — claim your Tome and manage your conversions.93<!-- tomevault:4.0:skill_md:2026-04-11 -->
tomevault-io