sync-rules

Synchronize rule updates across opt-in sibling projects with dry-run proposals and confirmation.

Updated Apr 27, 2026
One-click install
npx skills add https://github.com/vTRKA/supervibe --skill sync-rules-vtrka
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync-rules
Source: https://github.com/vTRKA/supervibe/tree/main/skills/sync-rules
Command: npx skills add https://github.com/vTRKA/supervibe --skill sync-rules-vtrka

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Syncing a configuration or “rules” change across multiple sibling projects is error-prone because AI tools can overwrite local customizations or apply changes without evidence.

Core Features & Use Cases

  • Opt-in multi-project propagation: Uses .supervibe/sync-config.yaml to determine which sibling projects are allowed to receive updates.
  • Evidence-first, dry-run diffing: Computes diffs against sibling rule versions and shows planned changes before any writes.
  • Local-customization protection: Detects divergent local edits and asks whether to merge, skip, or route to manual review.
  • Validation and auditability: Requires post-sync validation (rule-quality) and produces an audit log decision record per target.

Quick Start

Use an AI chat command like: “When I say ‘синхронизируй правила’, read the sync config, diff the updated rule against each opt-in sibling, show me the per-target dry-run changes, and only apply after I confirm.”

Frequently Asked Questions about sync-rules

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

FAQPage Schema
How do I propagate configuration changes across multiple projects without overwriting local customizations?

To propagate configuration changes safely, use an opt-in rules sync mechanism that reads a configuration file to determine allowed sibling projects. It computes dry-run diffs, detects divergent local edits, and asks whether to merge, skip, or route to manual review before applying any writes.

What is an evidence-first dry-run diff for rules synchronization?

An evidence-first dry-run diff for rules synchronization compares source and target rule versions to show planned changes before any writes occur. This mechanism ensures you review bounded proposals and confirm them before updates are applied to sibling projects.

How do I synchronize rule updates to sibling projects using a sync config file?

You synchronize rule updates by reading the `.supervibe/sync-config.yaml` file to determine which sibling projects are opt-in. The system then diffs the updated rule against each sibling, shows per-target dry-run changes, and applies the updates only after you explicitly confirm.

Can I share a baseline rule across multi-project stacks while allowing host adapter wording to diverge?

Yes, you can share an identical baseline rule across multi-project stacks while allowing host adapter wording to diverge. The synchronization process preserves local customizations and enforces validation, ensuring sibling projects maintain the shared baseline without losing local enforcement variations.

How do I ensure validation and auditability when syncing configuration updates across projects?

To ensure validation and auditability when syncing configuration updates, the synchronization process requires post-sync rule-quality validation and produces an audit log decision record per target. This enforced logging guarantees every configuration propagation event is fully traceable and verified.