project-setup

プロジェクトのセットアップ

基本原則

• 厳格な型付け：strict モードを有効にし、コンパイル時に型でバグを検出します
• 厳格なリント：デフォルトで厳格なルールを適用します。後から追加するより無効にするほうが簡単です
• 自動フォーマット：自動化して一貫性を保ち、手動でのフォーマットは不要にします
• 各段階でチェック：コミット前フックと CI を活用し、問題を早期に検出します
• テストをコードの近くに配置：foo.ts → foo.test.ts とし、テスト対象を明確にします
• 動作を重視：コードの仕組みではなく動作をテストし、外部との境界のみをモックします

ワークフロー

1. 言語ガイド（Python、TypeScript）を reference/ で確認します
2. ガイドがない場合は、WebSearch で「[language] project setup best practices」を検索します
3. セットアップは次の順に進めます：型付け → リント → フォーマット → テスト → コミット前チェック → CI
4. 既存のプロジェクトでは、同じ順序で段階的に移行します

リファレンスファイル

• reference/python.md - uv、ruff、basedpyright、pytest
• reference/typescript.md - pnpm、ESLint、Prettier、Vitest
• reference/common-patterns.md - テストの考え方、CI パターン、セキュリティ

ツールの選定

エコシステムの標準であり、積極的にメンテナンスされ、デフォルトで厳格、高速で、エディター・CI・コミット前チェックとの連携に優れたツールを優先します。

品質チェックリスト

• 型付け：最も厳格なモードを使用し、正当な理由なく any を使わない
• リント：厳格なルールを適用し、警告をエラーとして扱う
• フォーマット：保存時の自動フォーマットとコミット前チェックを設定する
• テスト：テストをコードの近くに配置し、カバレッジを 80% 超にする
• コミット前チェック：フォーマット、リント、型チェックを実施する
• CI：同じチェックとカバレッジレポートを実施する
• README：セットアップ手順を記載する
• 初回のコミットですべてのチェックに合格する