cross-repo-backporting

Coordinate cross-repo backporting with one PR per sibling repository.

1|Updated May 11, 2026
One-click install
npx skills add https://github.com/tlennon-ie/product-building-agents --skill cross-repo-backporting
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cross-repo-backporting
Source: https://github.com/tlennon-ie/product-building-agents/tree/main/.claude/skills/cross-repo-backporting
Command: npx skills add https://github.com/tlennon-ie/product-building-agents --skill cross-repo-backporting

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Cross-repo backporting prevents fleet-wide drift by defining what must stay consistent across sibling SaaS products and how to safely propagate changes without accidentally forking behavior or corrupting shared data.

Core Features & Use Cases

  • Classify changes as core vs product-specific so you know what must be synchronized (auth, RLS, billing/credits, pipelines, observability) versus what should intentionally diverge (brand, prompts, copy, product-only tables).
  • Canonical-product-first backport workflow that lands and burns in the change on a single canonical repo, then diffs, adapts, and backports to siblings with one PR per repo while tracking a propagation ledger.
  • Schema migration coordination and safety rules for shared tables, including author-once in the canonical product, verbatim copying, sequential numbering per product, and strict “never edit shipped migrations” guidance.

Quick Start

Ask your agent to backport a fleet change by first selecting the canonical product, then diffing touched backbone files across each sibling, and finally producing one scoped backport PR per sibling with documented adaptations and drift findings.

Frequently Asked Questions about cross-repo-backporting

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

FAQPage Schema
How do I keep sibling SaaS products in sync without causing fleet-wide drift?

To keep sibling SaaS products in sync, cross-repo backporting coordinates fleet-wide change propagation by classifying changes as core versus product-specific, ensuring shared behaviors like authentication and billing stay consistent while product-only features intentionally diverge.

What is the best way to propagate schema migrations across a multi-repo SaaS fleet?

The best way to propagate schema migrations across a multi-repo SaaS fleet is authoring migrations once in a canonical product, then verbatim copying them to siblings with sequential numbering per product, strictly avoiding edits to already shipped migrations.

How do I backport changes across multiple repositories for shared RLS policies?

Backporting changes for shared RLS policies requires a canonical-product-first workflow where you land changes in one canonical repo, diff the touched backbone files across siblings, adapt, and produce one scoped backport PR per sibling repo with verification.

When should I intentionally diverge behavior instead of synchronizing changes across SaaS products?

You should intentionally diverge behavior across SaaS products for elements like brand assets, user prompts, copywriting, and product-only tables, whereas core behaviors such as authorization, billing, and streaming pipelines must be synchronized to prevent drift.

Does cross-repo backporting require a canonical product before creating pull requests?

Yes, cross-repo backporting requires a canonical-product-first landing where the change burns in on a single canonical repository before diffing, adapting, and propagating one PR per sibling repo to ensure safe multi-repo change propagation.

Can I edit a shared schema migration after it has been shipped to a sibling product?

No, you must never edit shipped schema migrations in sibling products; high-stakes migration safety rules dictate authoring once in the canonical product and copying verbatim to avoid corrupting shared data across the SaaS fleet.