Template

Files

lmiranda 2d51df7a42 feat(marketplace): command consolidation + 8 new plugins (v8.1.0 → v9.0.0) [BREAKING]

Phase 1b: Rename all ~94 commands across 12 plugins to /<noun> <action>
sub-command pattern. Git-flow consolidated from 8→5 commands (commit
variants absorbed into --push/--merge/--sync flags). Dispatch files,
name: frontmatter, and cross-reference updates for all plugins.

Phase 2: Design documents for 8 new plugins in docs/designs/.

Phase 3: Scaffold 8 new plugins — saas-api-platform, saas-db-migrate,
saas-react-platform, saas-test-pilot, data-seed, ops-release-manager,
ops-deploy-pipeline, debug-mcp. Each with plugin.json, commands, agents,
skills, README, and claude-md-integration. Marketplace grows from 12→20.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-02-06 14:52:11 -05:00

3.0 KiB

Raw Blame History

name, description

name	description
deploy validate	Validate deployment configs for correctness, security, and best practices

/deploy validate

Validate Docker Compose, Caddyfile, and systemd configurations.

Skills to Load

skills/visual-header.md
skills/compose-patterns.md
skills/health-checks.md

Agent

Delegate to agents/deploy-validator.md.

Usage

/deploy validate [--target=<compose|caddy|systemd|all>] [--strict]

Options:

--target - Which config to validate (default: all)
--strict - Treat warnings as errors

Instructions

Execute skills/visual-header.md with context "Config Validation".

Phase 1: File Discovery

Locate configuration files:

docker-compose.yml / docker-compose.yaml
Caddyfile or caddy/Caddyfile
systemd/*.service
.env, .env.production, .env.development

Report any expected files that are missing.

Phase 2: Docker Compose Validation

Check against patterns from skills/compose-patterns.md:

Check	Severity	Description
Valid YAML syntax	Critical	File must parse correctly
Image tags pinned	Warning	Avoid `latest` tag in production
Healthchecks defined	Warning	All services should have healthchecks
Restart policy set	Warning	Should be `unless-stopped` or `always`
Resource limits	Info	Memory/CPU limits recommended for constrained hosts
Network isolation	Warning	Services should use dedicated network, not `host`
Volume permissions	Warning	Bind mounts should have explicit read/write mode
No hardcoded secrets	Critical	Secrets must use env_file or Docker secrets
Port conflicts	Critical	No duplicate host port mappings
Dependency ordering	Info	Services with depends_on should use health conditions

Phase 3: Caddyfile Validation

Check	Severity	Description
Valid syntax	Critical	Directives must be properly formatted
HTTPS configuration	Info	Automatic HTTPS or explicit cert paths
Reverse proxy targets	Warning	Target must match docker-compose service names
Security headers	Info	Recommend X-Frame-Options, CSP, HSTS
Duplicate routes	Critical	No conflicting route definitions

Phase 4: Environment File Validation

Check	Severity	Description
.env.example exists	Warning	Template for required variables
No secrets in .env.example	Critical	Example file must use placeholders
All referenced vars defined	Critical	docker-compose env vars must have values
Consistent across environments	Info	Same keys in dev/staging/prod

Phase 5: Report

## Validation Report

### Critical (must fix)
- [file:line] Description of issue
  Fix: Recommended solution

### Warnings (should fix)
- [file:line] Description of issue
  Fix: Recommended solution

### Info (consider)
- [file:line] Description of improvement

### Summary
- Critical: X | Warnings: Y | Info: Z
- Status: PASS / FAIL

User Request

$ARGUMENTS

3.0 KiB Raw Blame History