file-naming

File Naming Conventions

General Rules

Use lowercase kebab-case for all files and directories:

• ✅ betting-analytics.ts
• ✅ mcp-integration.md
• ✅ test-helpers.ts
• ❌ BettingAnalytics.ts
• ❌ MCP_Integration.md
• ❌ testHelpers.ts

No spaces or mixed case in filenames.

TypeScript Files

Source Files

src/
├── index.ts                    # Entry point
├── mcp/
│   ├── server.ts              # Single word or kebab-case
│   ├── tool-registry.ts
│   └── handlers/
│       ├── steam-moves.ts
│       └── risk-concentration.ts

Test Files

tests/
├── unit/
│   ├── clv.test.ts            # Preferred: feature.test.ts
│   ├── sharp-score.test.ts
│   └── bet-ticker-sniffer.test.ts
├── integration/
│   ├── queue-integration.test.ts
│   └── trigger-implementation.test.ts

Patterns:

• *.test.ts (preferred)
• *_test.ts (alternative)
• *.spec.ts (alternative)

Configuration Files

Standard names (keep as-is):

• ✅ package.json
• ✅ tsconfig.json
• ✅ wrangler.toml
• ✅ bunfig.toml

Environment configs:

• ✅ wrangler.staging.toml
• ✅ wrangler.production.toml

Documentation Files

Uppercase for major docs:

• ✅ README.md
• ✅ LICENSE
• ✅ CLAUDE.md
• ✅ CHANGELOG.md
• ✅ CONTRIBUTING.md

Uppercase for status/important docs:

• ✅ TESTING_STATUS.md
• ✅ MCP_INTEGRATION_STATUS.md
• ✅ AUTOMATION_GUIDE.md

Kebab-case for guides:

• ✅ quick-start.md
• ✅ debugging-guide.md
• ✅ api-reference.md

Script Files

scripts/
├── test-mcp.ts                # Kebab-case
├── test-handlers-direct.ts
├── format.ts
├── lint.ts
└── automation/
    └── build-and-test.ts

HTML Files

tools/
├── extension-checker.html     # Kebab-case
├── system-health-monitor.html
└── troubleshooting-guide.html

dashboards/
├── dashboard-enhanced.html    # Kebab-case
├── dashboard-pro.html
└── dashboard-positions.html

Directories

Always lowercase, kebab-case:

• ✅ browser-extension/
• ✅ node_modules/
• ✅ test-results/
• ❌ BrowserExtension/
• ❌ Node_Modules/