What problem does it solve?
This Skill eliminates the manual, error-prone work of orchestrating Step9 golden residential retailer tests, triaging failures, and verifying artifact parity for the Pear Commerce API codebase, which is critical for maintaining reliable retail integration functionality.
Core Features & Use Cases
- End-to-End Test Orchestration: Runs residential Stage9 tests for eligible retailers in parallel with a 4-retailer cap, tracks run status, and manages heartbeat automation for long-running test cycles.
- Automated Failure Triage & Fix Workflow: Classifies test failures (transport, source, artifact mismatch), enforces deterministic fix rules, and manages fixer and watchdog subagent workflows with strict regression checks.
- Artifact Parity Verification: Performs LLM-assisted semantic comparison of same-run curls to confirm A/C artifact alignment, with special handling for transport-only blocks like captcha or IP challenges.
- Use Case: A Pear Commerce engineer working on the
api.pearcommerce.com codebase can use this Skill to automate the full final-wave Step9 test cycle for retailers like Kroger, Target, and Walmart, eliminating manual run tracking and inconsistent failure resolution.
Quick Start
Use the step9-golden-test-and-fix skill to run residential Step9 golden tests for all non-hollywoodfeed retailers, automatically triage any failures, and verify artifact curl parity for the final test wave.