📚 Keep documentation close to the design/code

I find it works best to keep documentation as close to the code or design files as possible. There are several benefits:

• You can update, commit, and review documentation as part of the standard working process (pull requests, CI, etc.)
• You can use tools you are already using (like your favorite editor)
• It encourages the use of Markdown (the format AI works with)
• Claude Code, which you run from your working directory, has access to it. This has always been important, but with AI tools, it is even more important—more on that in future.