Skip to content

TW-4920: CLAUDE.md rewrite — rules, skill consolidation, path-scoped rules#74

Merged
qasim-nylas merged 1 commit into
mainfrom
feature/TW-4920-claude-md-rewrite
May 11, 2026
Merged

TW-4920: CLAUDE.md rewrite — rules, skill consolidation, path-scoped rules#74
qasim-nylas merged 1 commit into
mainfrom
feature/TW-4920-claude-md-rewrite

Conversation

@qasim-nylas
Copy link
Copy Markdown
Collaborator

Summary

  • Rewrote CLAUDE.md from 226 → 117 lines based on Karpathy's 4-rule template + 8 additional rules for multi-step agent workflows
  • Consolidated 19 skills → 5 (merged 4 into add-command and generate-tests, removed 14 that duplicated Claude's baseline capability)
  • Path-scoped 3 Go rules files so they only load when touching **/*.go
  • Eliminated all cross-file duplication across CLAUDE.md, skills, and rules
  • Saves ~4,100 tokens at startup per session

Changes

Area Before After
CLAUDE.md 226 lines 117 lines
Skills 19 files 5 files
Rules loaded on non-Go work 6 3
Startup token cost ~7,500 ~3,400

Test plan

  • New session loads CLAUDE.md without errors
  • /add-command skill loads and shows scope table (commands, flags, methods, types)
  • /generate-tests skill loads and shows integration test section
  • /review-pr, /run-tests, /security-scan load correctly
  • Rules files only load when touching Go files (verify with /context)
  • No stale references to deleted skills in any surviving file

…h-scoped rules

Rewrote CLAUDE.md from 226 to 117 lines based on research into
CLAUDE.md best practices (Karpathy template, ETH Zurich study,
Anthropic guidance). Consolidated 19 skills down to 5, added
path-scoping to Go rules, eliminated all cross-file duplication.

Saves ~4,100 tokens at startup per session.
@qasim-nylas qasim-nylas requested a review from AaronDDM May 11, 2026 16:56
@qasim-nylas qasim-nylas changed the title TW-4920: CLAUDE.md rewrite — Karpathy rules, skill consolidation, path-scoped rules TW-4920: CLAUDE.md rewrite — rules, skill consolidation, path-scoped rules May 11, 2026
Copy link
Copy Markdown
Collaborator

@AaronDDM AaronDDM left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM 👍

@qasim-nylas qasim-nylas merged commit 5667671 into main May 11, 2026
6 checks passed
@qasim-nylas qasim-nylas deleted the feature/TW-4920-claude-md-rewrite branch May 11, 2026 16: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