namespace-organization

Define Dataico namespace conventions for architecture layers and domain grouping.

1|Updated Aug 16, 2018
One-click install
npx skills add https://github.com/saskenuba/dotfiles --skill namespace-organization
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: namespace-organization
Source: https://github.com/saskenuba/dotfiles/tree/main/ai/.claude/skills/namespace-organization
Command: npx skills add https://github.com/saskenuba/dotfiles --skill namespace-organization

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This guide helps teams structure the Dataico codebase by defining architecture layers, domain organization, and code placement, reducing confusion during feature additions and refactoring.

Core Features & Use Cases

  • Namespace discipline: Standardizes where to place models, queries, mutations, and UI code.
  • Domain-aligned structure: Aligns folders and namespaces with business domains (accounting, invoicing, payroll, party, etc.).
  • Refactoring safety: Provides a reference during code changes to minimize cross-layer churn and misplacements.

Quick Start

Use the namespace conventions to create new modules under the appropriate dataico.* namespaces and maintain consistent naming.

Frequently Asked Questions about namespace-organization

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

FAQPage Schema
How do I organize code in a domain-driven project to improve maintainability?

Organizing code in a domain-driven project requires aligning folders and namespaces with business domains like accounting or payroll. This structure standardizes code placement for models and queries, reducing confusion during refactoring and feature development.

What is the best way to structure namespaces for architecture layers and domain grouping?

The best way to structure namespaces is enforcing naming conventions that map folders directly to business domains. This domain-aligned structure defines clear architecture layers, ensuring scalable growth and minimizing cross-layer churn during code changes.

Where should I place new modules when doing refactoring in a complex codebase?

When refactoring a complex codebase, place new modules under appropriate domain-specific namespaces. Following namespace discipline for module creation provides a reference during code changes, minimizing misplacements and ensuring consistent onboarding across teams.

How does namespace naming convention affect code organization for new feature development?

Namespace naming conventions affect code organization by standardizing where to place models, mutations, and UI code. Enforcing folder alignment with business domains ensures consistent naming and reduces confusion during onboarding and new feature development.

Do I need domain-driven design to scale code organization across multiple teams?

Using domain-driven design to scale code organization across teams requires grouping code by business domains such as invoicing and payroll. This approach enforces namespace discipline and clear boundaries, enabling consistent onboarding and scalable growth.

When should I not use a domain-aligned namespace structure for my software engineering project?

You should not use a domain-aligned namespace structure when it creates excessive cross-layer churn or misplacements during refactoring. If the architecture layers do not map cleanly to business domains, standard naming conventions may hinder scalable growth.