feat(dev-readyz): convert skill to 12-gate orchestrator with compliance audit

Browse source

Transforms dev-readyz from an inline implementation spec into an orchestrator matching the dev-multi-tenant and dev-systemplane-migration pattern. The skill now dispatches ring:backend-engineer-{golang,typescript} and ring:frontend-bff-engineer-typescript per gate; the orchestrator only detects, verifies, and enforces order.

Gate 0 runs three phases: stack detection, S1-S9 /readyz compliance audit (endpoint path, status vocabulary, aggregation rule, response fields, TLS detection, ValidateSaaSTLS, metrics, self-probe, graceful drain), and N1-N7 anti-pattern detection (response caching, /ready alias, /health/live+/health/ready split, substring TLS detection, reflection-based TLS, inline SaaS TLS checks, process.exit in Next.js instrumentation). Anti-patterns BLOCK progression until removed. Each S/N check maps to the specific gate that fixes it.

Gate 1.5 generates a visual HTML preview via ring:visualize that the user must approve before any code changes. Gate 9 dispatches 10 parallel reviewers with readyz-specific context. Gate 10 requires explicit user validation. Gate 11 generates an operator activation guide at docs/readyz-guide.md. State is persisted to docs/ring-dev-readyz/current-cycle.json for resume.

The anti-patterns encoded in Gate 0 Phase 3 were identified by auditing real implementations in matcher and plugin-br-bank-transfer: 5-second response cache layer, strings.Contains(uri, "tls=true") substring match, /ready alias path, and missing metrics emission despite otherwise-compliant /readyz handlers.

X-Lerian-Ref: 0x1

...

This commit is contained in:

Fred Amaral 2026-04-20 11:58:00 -03:00

parent 1b406b82a5

commit a33c5bbdc8

No known key found for this signature in database

GPG key ID: ADFE56C96F4AC56A

1 changed files with 1533 additions and 283 deletions

Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL

Show stats Download patch file Download diff file Expand all files Collapse all files

1816

dev-team/skills/dev-readyz/SKILL.md

View file

File diff suppressed because it is too large Load diff