Repository navigation
v1.3.0 - Major Context Reduction (79% smaller)
π― 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 andYYYY-MM-DD-file naming - β Workflow loop: Plan β Review β Execute β Summarize β Archive
- β
context/context.mdJSON 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