Organizing Specs in Your Repository: File Structure and Git Workflow
A practical guide to structuring spec files in your repository, maintaining a spec index, naming conventions, and integrating specs into your Git workflow—including how to use specs effectively with AI coding tools.
Specs only work if your team can find them, read them, and trust they're current. This guide covers how to organize spec files in your repository and integrate them into your Git workflow.
Recommended Directory Structure
Keep specs close to the code they describe: