[MODEL] Claude Code violated its own documentation directive and created excessive documentation files not requested by the user.

Resolved 💬 3 comments Opened Jan 22, 2026 by jimbursch1 Closed Feb 28, 2026

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_

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗