What Belongs In A CLAUDE.md
A useful CLAUDE.md gives AI coding assistants stable project boundaries, commands, architecture rules, and review expectations.
The purpose of CLAUDE.md
A CLAUDE.md file should tell an AI coding assistant how to work safely inside a project. It is not a product brief, a style manifesto, or a replacement for architecture documentation.
The strongest files define commands, ownership boundaries, testing expectations, and the rules that should never be silently changed.
Keep it operational
Good assistant instructions are executable. They say which build command to run, which folders map to which services, and when a change needs explicit approval.
Weak instructions are vague. They ask the assistant to be careful, thoughtful, or production ready without saying what those words mean in this codebase.
Connect it to the architecture
The file should point to the real source of truth. If architecture lives in docs, the assistant should read the relevant doc before opening implementation files.
Logic64 generates governance files as part of the workspace because AI assistants need local instructions that match the actual project structure.