Bulletproof Solidity🛡️

The article proposes a framework for organizing Solidity smart contracts and their tests so that codebases stay clean, modular and easy to navigate as projects grow. It is inspired by Aave V2's repository and is presented for DeFi protocols, though the author says it can be adapted to other projects with minor adjustments. Contracts are split into interfaces, mocks and protocol directories, with the protocol directory further divided into common, libraries, misc, core, integrations and tokenization. Tests are grouped by type (common, unit, fork, fuzz, invariant) and then by feature, with contract names suffixed by the test type so CI can run selected suites, such as forge test --mt UnitTest.