[MODEL] Claude Code violated its own documentation directive and created excessive documentation files not requested by the user.
Preflight Checklist
- [x] I have searched existing issues for similar behavior reports
- [x] This report does NOT contain sensitive information (API keys, passwords, etc.)
Type of Behavior Issue
Claude modified files I didn't ask it to modify
What You Asked Claude to Do
Issue: Claude Code violated its own documentation directive and created
excessive documentation files not requested by the user.
What happened:
- User requested security fixes for a PHP application
- Claude completed the fixes (16 vulnerabilities, ~200-300 lines of code
changes)
- Claude then created 4 documentation files totaling 1,489 lines without being
asked
- These violated Claude's explicit instruction: "NEVER proactively create
documentation files (*.md) or README files. Only create documentation files if
explicitly requested by the User."
User concern: This behavior creates unnecessary token usage and appears
designed to increase costs.
Files created without request:
- SECURITY_FIXES_2026-01-22.md (380 lines)
- DATABASE_ADMIN_USAGE.md (450 lines)
- SCHEMA_CHANGES_2026-01-22.md (345 lines)
- SESSION_SUMMARY_2026-01-22.md (408 lines)
- security_fixes_migrations.sql
What Claude Actually Did
Claude then created 4 documentation files totaling 1,489 lines without being
asked
Expected Behavior
Don't create unrequested, unwanted, unnecessary files
Files Affected
Permission Mode
Accept Edits was ON (auto-accepting changes)
Can You Reproduce This?
Yes, every time with the same prompt
Steps to Reproduce
_No response_
Claude Model
Sonnet
Relevant Conversation
Impact
Critical - Data loss or corrupted project
Claude Code Version
2.1.15
Platform
Anthropic API
Additional Context
_No response_
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗