[Feature Request] Document configuration file structure and directory hierarchy rationale

Bug Description
Subject: Documentation request - Configuration file structure rationale

I noticed that Claude Code stores its main configuration file at ~/.claude.json while all other configuration data resides in the ~/.claude/ directory.

Could you document the architectural reasoning behind this separation? Specifically:

• Why is ~/.claude.json at the home root instead of ~/.claude/config.json?
• Is there a semantic distinction between data stored in ~/.claude.json vs ~/.claude/settings.json?

This would help users better understand the configuration hierarchy and avoid confusion when organ…
Note: Content was truncated.