aif-best-practices

Universal code quality guidelines applicable to any language or framework.

Context: If .ai-factory/ARCHITECTURE.md exists, follow its folder structure, dependency rules, and module boundaries alongside these guidelines.

| Naming | Descriptive, consistent, reveals intent | | Functions | Small, single purpose, no side effects | | Errors | Specific types, never swallow, log context | | Tests | AAA pattern, test behavior, descriptive names | | Reviews | Be specific, suggest solutions, be kind |

コード品質のガイドラインと、クリーンで保守可能なコードを作成するためのベスト プラクティス。命名、構造、エラー処理、テスト、およびコードレビュー標準について説明します。コードの作成、レビュー、リファクタリング、または「これにどのような名前を付けるべきか」、「ベスト プラクティス」、「クリーンなコード」を尋ねるときに使用します。 ソース: lee-to/ai-factory。