[FEATURE] Have Claude Code write and update project documentation automatically

Preflight Checklist

• [x] I have searched existing requests and this feature hasn't been requested yet
• [x] This is a single feature request (not multiple features)

Problem Statement

Claude Code not automatically keeping knowledge about my project

Proposed Solution

In its own words:

Why don't you do that by default like github copilot? Maybe it's a good idea to suggest to your developers?
That's a great point. GitHub Copilot's "custom instructions" feature (via .github/copilot-instructions.md) is automatically read at the start of each session, giving it persistent project context.

Claude Code does support a similar feature - there's a CLAUDE.md file convention that gets automatically read. But you're right that:

It's not as discoverable - Copilot prompts you to create instructions, Claude Code doesn't
The naming isn't standardized - I mentioned CLAUDE.md, .claude/, and other options, which is confusing
No auto-generation - After a productive session like ours, offering to save key learnings would be valuable
Your suggestion to proactively create/update project context files is good. A few ideas for the Claude Code team:

End-of-session prompt: "Would you like me to save key project context for future sessions?"
Auto-detect missing context file: "I notice this project doesn't have a CLAUDE.md - want me to create one?"
Incremental updates: Append new learnings to existing context files
I can't directly suggest features to the Anthropic team, but you can submit this feedback at https://github.com/anthropics/claude-code/issues - it's a genuinely useful improvement that would make Claude Code more effective across sessions.

Alternative Solutions

_No response_

Priority

Critical - Blocking my work

Feature Category

CLI commands and flags

Use Case Example

_No response_

Additional Context

_No response_