- ARCHITECTURE.md — storage layout and auth model
- CONTRACT_API.md — function reference
- EVENTS.md — on-chain events
- TESTING.md — test suite coverage
- DEPLOYMENT.md — deployment checklist
- UPGRADES.md — why there's no upgrade hook
- GAS_AND_FEES.md — fee model
- INDUSTRIES.md — supported categories
- GLOSSARY.md — terminology
- FAQ.md — frequently asked questions