Skip to content

v1.3.0 - Major Context Reduction (79% smaller)

Choose a tag to compare

@brian-lai brian-lai released this 07 Feb 22:13
· 119 commits to main since this release

🎯 Major Token Efficiency Improvement

This release dramatically reduces the PARA plugin's context footprint by 79% (2,957 β†’ 621 lines), saving ~7k tokens in every Claude session.

Changes

File Size Reductions:

  • resources/CLAUDE.md: 967 β†’ 121 lines (87% ↓)
  • commands/plan.md: 607 β†’ 98 lines (84% ↓)
  • commands/execute.md: 422 β†’ 91 lines (78% ↓)
  • commands/help.md: 362 β†’ 66 lines (82% ↓)
  • commands/check.md: 151 β†’ 37 lines (75% ↓)
  • commands/init.md: 176 β†’ 62 lines (65% ↓)
  • commands/status.md: 89 β†’ 50 lines (44% ↓)
  • commands/summarize.md: 86 β†’ 39 lines (55% ↓)
  • commands/archive.md: 97 β†’ 57 lines (41% ↓)

What Was Removed

Content that was redundant, aspirational (MCP), or standard LLM behavior:

  • Full/minimal CLAUDE.md templates (~210 lines)
  • Tool Output Guidance section (~180 lines) - all default Claude behavior
  • MCP aspirational sections (~100 lines) - not yet implemented
  • Meta-commentary, philosophy, closing thoughts (~50 lines)
  • Redundant directory explanations
  • "Why" justifications, duplicate decision trees
  • Example questions, worked examples, ASCII flowcharts
  • Anti-patterns, "be a good AI" instructions

What's Preserved

All core behavioral rules remain intact:

  • βœ… context/ directory structure and YYYY-MM-DD- file naming
  • βœ… Workflow loop: Plan β†’ Review β†’ Execute β†’ Summarize β†’ Archive
  • βœ… context/context.md JSON block format
  • βœ… Git conventions: para/{task-name} branches, commit-per-todo
  • βœ… Collaborative planning with AskUserQuestion
  • βœ… Simple vs phased plan support
  • βœ… All workflow commands

Impact

  • Token savings: ~7,000 fewer tokens per session
  • Faster loading: 79% less content to process
  • Same functionality: Zero behavioral changes
  • Better maintainability: Leaner, focused documentation

Migration

If you have an existing ~/.claude/CLAUDE.md from a previous version, it will contain the old verbose version. To update:

```bash

Backup your current global file

cp ~/.claude/CLAUDE.md ~/.claude/CLAUDE.md.backup

The plugin will copy the new trimmed version on next /para:init

Or manually copy from the plugin:

cp /path/to/para-programming-plugin/resources/CLAUDE.md ~/.claude/CLAUDE.md
```


Full Changelog: v1.2.5...v1.3.0