Skip to content

docs: streamline CLAUDE.md based on benchmark findings#1604

Merged
lukaszlenart merged 1 commit intomainfrom
docs/streamline-claude-md
Mar 2, 2026
Merged

docs: streamline CLAUDE.md based on benchmark findings#1604
lukaszlenart merged 1 commit intomainfrom
docs/streamline-claude-md

Conversation

@lukaszlenart
Copy link
Member

@lukaszlenart lukaszlenart commented Mar 2, 2026

Summary

  • Streamline CLAUDE.md from 142 to 64 lines based on CLAUDE.md benchmarking study (1,188 tests across 3 models)
  • Remove redundant sections (Available Tools, Common Pitfalls, verbose build commands, Technology Stack)
  • Reframe security directives from prohibitions to positive directives (study found negative framing scores -0.66 points)
  • Retain only project-specific knowledge Claude cannot infer from the codebase

Test plan

  • Verify CLAUDE.md renders correctly on GitHub
  • Confirm project-specific content (PR conventions, security patterns, build flags) is preserved
  • Validate no essential project-unique information was removed

🤖 Generated with Claude Code

Apply recommendations from CLAUDE.md benchmarking study (1,188 tests
across 3 models): remove redundant generic instructions, reframe
prohibitions as positive directives, trim inferable content, and
keep only project-specific knowledge that Claude cannot derive from
the codebase itself. Reduces file from 142 to 64 lines.

Key changes:
- Remove Common Pitfalls (negative framing, generic, duplicated)
- Remove Available Tools section (redundant with system prompt)
- Trim build commands to project-specific flags only
- Collapse Technology Stack into one-line overview
- Reframe security directives from "never do X" to "do Y instead"

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@lukaszlenart lukaszlenart enabled auto-merge (squash) March 2, 2026 11:27
@lukaszlenart lukaszlenart merged commit 4d96950 into main Mar 2, 2026
6 of 7 checks passed
@lukaszlenart lukaszlenart deleted the docs/streamline-claude-md branch March 2, 2026 11:31
@sonarqubecloud
Copy link

sonarqubecloud bot commented Mar 2, 2026

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant