pear-engineering-workflow

Standardize Pear Commerce engineering workflows for PRs, deploys, and testing.

Updated May 15, 2026
One-click install
npx skills add https://github.com/Pear-Commerce/pear-ai-skills --skill pear-engineering-workflow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pear-engineering-workflow
Source: https://github.com/Pear-Commerce/pear-ai-skills/tree/main/skills/pear-engineering-workflow
Command: npx skills add https://github.com/Pear-Commerce/pear-ai-skills --skill pear-engineering-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill eliminates inconsistent practices and production risks when working on Pear Commerce repositories, ensuring all engineering work follows standardized, team-approved patterns for code changes, reviews, and deployments.

Core Features & Use Cases

  • PR Management: Enforces DevRev ticket linking for all Pear PRs, provides code review standards, and guides PR improvement to meet team quality bars.
  • Safe Deploy & Validation: Covers deploy safety rules for Pear services, real data checks via db.sh, production JSP probes for live server inspection, and browser end-to-end verification for user-facing flows.
  • Concurrent Work Management: Guides correct worktree usage for isolated, non-conflicting edits across multiple Pear repositories, and provides shell environment setup guidance to avoid tooling-related failures. Use Case: When editing api.pearcommerce.com to fix a retailer UPC resolver, this Skill guides you to use a dedicated codex/ worktree, link the relevant DevRev ticket, run tests against the shared dev DB, follow PearEntity serialization rules, and verify the fix with a live JSP probe before opening the PR.

Quick Start

Use the pear-engineering-workflow skill to review your pending PR for admin.pearcommerce.com and ensure it includes a DevRev ticket link, follows all Pear code standards, and passes required checks before merging.

Frequently Asked Questions about pear-engineering-workflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I link a DevRev ticket to my Pear Commerce pull request?

To link a DevRev ticket to your Pear Commerce pull request, you must enforce mandatory DevRev ticket linking within the PR management workflow. This standardized practice ensures all code changes are tracked and meet team quality bars before merging.

What is the correct way to use git worktrees for concurrent Pear Commerce development?

Using git worktrees for concurrent Pear Commerce development involves creating isolated, non-conflicting edits across multiple repositories. This concurrent work management approach prevents tooling-related failures and keeps parallel feature branches cleanly separated.

How do I validate database changes safely before deploying Pear Commerce services?

To validate database changes safely before deploying Pear Commerce services, run real data checks using db.sh against the shared dev DB. This deploy safety rule ensures your modifications do not introduce production risk during code changes.

How do I verify a fix in api.pearcommerce.com before opening a pull request?

To verify a fix in api.pearcommerce.com before opening a pull request, use a dedicated codex/ worktree, run tests against the shared dev DB, and verify the fix with a live JSP probe. This ensures production-grade code review standards are met.

Does the Pear engineering workflow require browser end-to-end testing for admin.pearcommerce.com?

Yes, the Pear engineering workflow requires browser end-to-end testing for admin.pearcommerce.com to verify user-facing flows. This standardized testing eliminates inconsistent practices and reduces production risk during deployments.

What are the PearEntity serialization rules I need to follow for code reviews?

PearEntity serialization rules are production-grade code review standards enforced during Pear engineering work. Following these rules ensures your code changes eliminate inconsistent practices and reduce production risk before deployment.