opencode-conflict-prevention

What problem does it solve?

Guidelines to prevent conflicts when OpenCode plugins load, deduplicate, and name plugins, reducing integration issues during plugin development and publishing.

Core Features & Use Cases

• Plugin Loading Priority: Later sources override earlier ones to ensure predictable behavior.
• Deduplication Mechanism: Same plugin name from different sources is collapsed to a single winner by priority.
• Naming Conventions: Use scoped names and descriptive identifiers to minimize conflicts.
• Common Conflict Scenarios: Local vs npm, duplicate names, hook conflicts, with recommended resolutions.
• Troubleshooting Conflicts: Diagnosis steps and checks to isolate issues.
• Publishing Guidelines: Before publishing, test for conflicts and document compatibility.
• Best Practices: Documentation, testing, and safe hooks.

Quick Start

Review the guidelines and apply the loading priority, deduplication rules, and naming recommendations when developing or publishing OpenCode plugins.