Skip to main content

commands-naming-check

type: command component_type: command name: naming-check description: Check and fix file/directory naming conventions usage: /naming-check [--fix|--suggest] [path] arguments:

  • name: path type: string required: false description: Path to check (default: current directory) options:
  • name: --fix type: boolean default: false description: Automatically fix naming violations
  • name: --suggest type: boolean default: false description: Show fix suggestions without applying
  • name: --recursive type: boolean default: true description: Check subdirectories
  • name: --type type: string default: all description: Check specific type (files|dirs|all) moe_confidence: 0.860 track: H quality_score: 75 moe_classified: 2026-01-03 last_reviewed: '2026-02-12'

/naming-check - Naming Convention Check Command

Purpose​

Validate file and directory names against CODITECT naming conventions, with optional auto-fix.

Usage​

# Check current directory
/naming-check

# Check specific path
/naming-check docs/

# Show fix suggestions
/naming-check --suggest

# Auto-fix violations
/naming-check --fix

# Check only files
/naming-check --type files

Naming Rules​

TypeConventionExample
Directorieskebab-casemy-directory/
Python filessnake_casemy_module.py
TypeScriptkebab-casemy-service.ts
React componentsPascalCaseMyComponent.tsx
Standard docsUPPER-KEBABREADME.md
Config fileskebab-caseapp-config.json

Output​

Check Report​

## Naming Convention Report

Compliance: 88%
Violations: 14

| Current | Should Be | Location |
|---------|-----------|----------|
| MyFile.md | my-file.md | docs/ |
| API_Handler.py | api_handler.py | scripts/ |
| readme.md | README.md | root |

Suggestions​

## Fix Suggestions

Execute these commands to fix:

git mv "docs/MyFile.md" "docs/my-file.md"
git mv "scripts/API_Handler.py" "scripts/api_handler.py"
git mv "readme.md" "README.md"

Fix Report​

## Naming Fixes Applied

Fixed: 14 violations

| Original | New Name | Status |
|----------|----------|--------|
| MyFile.md | my-file.md | ✓ |
| API_Handler.py | api_handler.py | ✓ |

Compliance: 88% → 100%
  • /organize - Full organization
  • /structure - Structure validation
  • /production-audit - Production check

Agents Used​

  • naming-convention-enforcer

Action Policy​

<default_behavior> This command analyzes and reports by default. Provides:

  • Compliance percentage
  • Violations list
  • Fix suggestions

Only fixes when --fix flag used. </default_behavior>

After check, verify: - All files scanned - Violations identified - Fixes applied (if --fix) - Report generated

Success Output​

When naming-check completes:

✅ COMMAND COMPLETE: /naming-check
Path: <checked-path>
Files: N scanned
Violations: N found
Compliance: N%
Fixed: N (if --fix)

Completion Checklist​

Before marking complete:

  • Path scanned
  • Violations identified
  • Report generated
  • Fixes applied (if --fix)

Failure Indicators​

This command has FAILED if:

  • ❌ Path not found
  • ❌ No files scanned
  • ❌ Fix failed
  • ❌ Report not generated

When NOT to Use​

Do NOT use when:

  • External dependencies
  • Generated files
  • Vendor directories

Anti-Patterns (Avoid)​

Anti-PatternProblemSolution
Skip --suggestBlind fixesPreview first
Force fix allBreaking changesReview suggestions
Ignore exclusionsFalse positivesUse .namingignore

Principles​

This command embodies:

  • #6 Clear, Understandable - Clear naming rules
  • #3 Complete Execution - Full directory scan
  • #9 Based on Facts - Convention-based check

Full Standard: CODITECT-STANDARD-AUTOMATION.md

Version: 1.0.0 Created: 2026-01-02