Skip to content

Slim down CLAUDE.md to project-specific guardrails#1605

Merged
lukaszlenart merged 1 commit intorelease/struts-6-8-xfrom
slim-claudemd
Mar 9, 2026
Merged

Slim down CLAUDE.md to project-specific guardrails#1605
lukaszlenart merged 1 commit intorelease/struts-6-8-xfrom
slim-claudemd

Conversation

@lukaszlenart
Copy link
Member

@lukaszlenart lukaszlenart commented Mar 2, 2026

Summary

  • Remove generic architecture descriptions, common patterns, and technology lists that Claude already knows from training
  • Keep only build commands, project-specific traps (javax.servlet, OGNL sandbox, RAT headers), and module layout
  • Reduce from ~160 lines to ~35 lines

Based on CLAUDE.md benchmark results showing that generic instructions degrade performance on bug-fix and code-generation tasks, while project-specific guardrails raise worst-case scores.

Test plan

  • Verify Claude Code still picks up build commands and project rules from the slimmed file
  • Confirm no project-specific traps were lost (javax.servlet, OGNL security, RAT headers, plugin descriptors)

🤖 Generated with Claude Code

@sonarqubecloud
Copy link

sonarqubecloud bot commented Mar 9, 2026

Quality Gate Failed Quality Gate failed

Failed conditions
24 Security Hotspots
42.5% Coverage on New Code (required ≥ 80%)
3.4% Duplication on New Code (required ≤ 3%)
E Security Rating on New Code (required ≥ A)
E Reliability Rating on New Code (required ≥ A)

See analysis details on SonarQube Cloud

Catch issues before they fail your Quality Gate with our IDE extension SonarQube for IDE

@lukaszlenart lukaszlenart merged commit a0d4f21 into release/struts-6-8-x Mar 9, 2026
9 of 10 checks passed
@lukaszlenart lukaszlenart deleted the slim-claudemd branch March 9, 2026 08:57
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.

2 participants