Project Setup

Core Principles

• Strong Typing: Strict mode enabled; types catch bugs at compile time
• Strong Linting: Strict rules by default; easier to disable than add later
• Auto Formatting: Automated and consistent; no manual formatting
• Checks at Every Stage: Pre-commit hooks + CI; catch issues early
• Co-located Tests: foo.ts → foo.test.ts; obvious what's tested
• Behavior-Focused: Test what code does, not how; mock only external boundaries

Workflow

1. Check reference/ for language guide (Python, TypeScript)
2. If no guide: WebSearch "[language] project setup best practices"
3. Follow setup: typing → linting → formatting → testing → pre-commit → CI
4. For existing projects: migrate incrementally in same order

Reference Files