orkestra-mongo-collection-naming

Standardize MongoDB collection naming conventions and repository access patterns in Orkestra backend architecture.

1|1|Updated Dec 20, 2025
One-click install
npx skills add https://github.com/orkestra-cc/orkestra --skill orkestra-mongo-collection-naming
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: orkestra-mongo-collection-naming
Source: https://github.com/orkestra-cc/orkestra/tree/main/.claude/skills/orkestra-mongo-collection-naming
Command: npx skills add https://github.com/orkestra-cc/orkestra --skill orkestra-mongo-collection-naming

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill prevents architectural drift and debugging friction by enforcing strict, predictable naming conventions for MongoDB collections within the Orkestra backend.

Core Features & Use Cases

  • Standardized Prefixes: Automatically validates that collections follow either the module-prefix or tier-pair (operator/client) naming patterns.
  • Code Quality Enforcement: Ensures that all database interactions use constant references rather than hardcoded string literals.
  • Use Case: When adding a new feature to an addon, use this skill to verify that your collection names and repository access patterns align with the core Orkestra architecture, preventing technical debt.

Quick Start

Use the orkestra-mongo-collection-naming skill to audit the current backend repository for non-compliant collection naming patterns and hardcoded database literals.

Frequently Asked Questions about orkestra-mongo-collection-naming

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

FAQPage Schema
How do I enforce consistent MongoDB collection naming conventions in a backend architecture?

You can enforce MongoDB collection naming conventions by applying module-prefixed or tier-split patterns and requiring constant-based collection references for all database repository methods. This prevents architectural drift and debugging friction.

What is the best way to standardize MongoDB repository access patterns across core modules and addons?

Standardizing MongoDB repository access patterns requires replacing hardcoded string literals with constant-based collection references. This ensures predictable database interactions and maintains architectural alignment across all core modules and addons.

Why does using hardcoded string literals for MongoDB collections cause architectural drift?

Hardcoded string literals cause architectural drift because they bypass module-prefixed or tier-split naming rules, creating unpredictable collection names that increase debugging friction and technical debt across the backend.

Can I audit my existing backend for non-compliant MongoDB collection names?

Yes, you can audit your backend repository to identify non-compliant MongoDB collection naming patterns and hardcoded database literals. This process verifies that your collection names align with core architecture rules.

When do I need to use module-prefixed or tier-split naming rules for MongoDB collections?

You need module-prefixed or tier-split naming rules when defining collection specifications and implementing database repository methods within the backend architecture. This applies specifically to core modules and addon development.

Does this MongoDB naming convention approach work for both core modules and addons?

Yes, this MongoDB naming convention approach applies to the implementation of database repository methods and collection specifications across both core modules and addons, ensuring consistent architectural compliance throughout the backend.