By shihwesley
TLDR-aware code simplifier — uses AST summaries for context, full reads only for target files. 80%+ token savings on large codebases. Merkle-integrated for O(1) change detection when used with mercator-ai.
npx claudepluginhub shihwesley/shihwesley-plugins --plugin code-simplifier-tldrClaude Code plugin that simplifies code using TLDR-aware AST summaries. Reads structure first via lightweight summaries, then targets only the files that need changes. Saves 80%+ tokens compared to reading every file fully.
When paired with mercator-ai, it uses the merkle manifest for O(1) change detection — only looking at files that actually changed.
# From the shihwesley-plugins marketplace
/plugin marketplace add shihwesley/shihwesley-plugins
/plugin install code-simplifier-tldr@shihwesley-plugins
# Or install directly from GitHub
/plugin install --source github shihwesley/code-simplifier-tldr
# Simplify recently modified files
/simplify-tldr
# Simplify a specific file
/simplify-tldr src/api/auth.ts
# Simplify files matching a pattern
/simplify-tldr src/components/*.tsx
The agent can also be triggered automatically by Claude Code when code simplification tasks are detected.
┌─────────────────────────────────────────────┐
│ 1. Merkle check (if mercator-ai installed) │
│ docs/.mercator.json → what changed? │
├─────────────────────────────────────────────┤
│ 2. TLDR summaries for changed files │
│ AST structure, ~200 tokens per file │
├─────────────────────────────────────────────┤
│ 3. Line-range reads for target sections │
│ Only the functions you'll modify │
├─────────────────────────────────────────────┤
│ 4. Edit → Verify → Log │
│ Changes recorded in SIMPLIFICATION_LOG │
└─────────────────────────────────────────────┘
Token cost comparison (100-file codebase, 3 files changed):
| Approach | Tokens |
|---|---|
| Read all files fully | ~250,000 |
| TLDR all files | ~20,000 |
| Merkle diff + TLDR changed | ~650 |
SIMPLIFICATION_LOG.md| Type | File | Purpose |
|---|---|---|
| Agent | agents/code-simplifier.md | Core simplifier with TLDR + merkle protocol |
| Command | commands/simplify.md | /simplify slash command entry point |
docs/.mercator.json merkle manifest for O(1) change detection. Optional but recommended.MIT
Complete collection of battle-tested Claude Code configs from an Anthropic hackathon winner - agents, skills, hooks, rules, and legacy command shims evolved over 10+ months of intensive daily use
Uses power tools
Uses Bash, Write, or Edit tools
Comprehensive .NET development skills for modern C#, ASP.NET, MAUI, Blazor, Aspire, EF Core, Native AOT, testing, security, performance optimization, CI/CD, and cloud-native applications
Complete collection of battle-tested Claude Code configs agents, skills, hooks, rules, and legacy command shims evolved over 10+ months of intensive daily use
Unity Development Toolkit - Expert agents for scripting/refactoring/optimization, script templates, and Agent Skills for Unity C# development
Complete collection of battle-tested Claude Code configs from an Anthropic hackathon winner - agents, skills, hooks, and rules evolved over 10+ months of intensive daily use
Complete collection of battle-tested Claude Code configs from an Anthropic hackathon winner - agents, skills, hooks, and rules evolved over 10+ months of intensive daily use