plugin-architecture-convention

What problem does it solve?

This Skill establishes the foundational architectural principles for AI plugins, ensuring they are designed for reusability, maintainability, and scalability. It clarifies the roles of agents, skills, and commands, and dictates how dependencies are managed to prevent tightly coupled systems.

Core Features & Use Cases

• Role Definition: Clearly outlines the responsibilities of agents (overall phase/domain), skills (single-purpose workflow/convention), and commands (orchestration).
• Dependency Management: Enforces that commands manage all dependencies, ensuring agents and skills remain independent and reusable.
• Independence & Generality: Prohibits cross-element references and the use of proper nouns within agents and skills, maximizing their portability and reusability across projects.
• Use Case: When starting a new AI plugin project, use this skill to define the core structure. It will guide you to design independent skills like code-generator and coding-convention, and then orchestrate them via a generate-code command, ensuring a clean, modular architecture.

Quick Start

Explain the core architectural principles for designing a new AI plugin, focusing on agent, skill, and command roles.