house-rules

開発ルール

コードと、それを説明するすべての内容は、writing-lean スキルを使って記述します。

• 依存関係ではなく、私たちのコードをテストします。 私たちのコードが追加する動作をテストし、パッケージは所与のものとして扱います。その値はテーブルをコピーせずにインポートし、動作のテストはパッケージ自体に任せます。
• 信頼できる情報源は一つにします。 各値は定義されている場所から取得します。Tailwind のスケール（max-w-[1468px] ではなく max-w-7xl）、共有定数、またはパッケージ独自の型を使います。
• 用語集のドメイン用語を使います。 clhbid/CLHbid-LiveAuction の GLOSSARY.md は、アプリにおける唯一の信頼できる情報源です。domain-modeling スキルを使って読み、そこにある用語を使います。Avoid と記された用語は使わず、用語が不足している場合は新しい用語を作らずに、用語集への追加を提案します。
• 仕様の書き方。 テストフレームワークのフックでセットアップと後処理を行います。準備、実行、検証の順に進め、結果全体を検証して、項目が一つでも余分にあればテストが失敗するようにします。
• 仕様が時刻に依存する場合は、常に時計を偽装します。 これにより、どの時刻やタイムゾーンでもテストが成功します。