Skip to content

v0.3.0

Choose a tag to compare

View all tags
@cschweda cschweda released this 17 Apr 14:21
v0.3.0
d5b850d

What changed

Narrowed Step 1's default read scope in refine.md to cut token/context overhead on every /refine invocation.

Before (v0.2.0)

Step 1 read CLAUDE.md, package.json, README, and any obviously relevant source files on every invocation — regardless of whether the rough prompt needed that context.

After (v0.3.0)

Step 1 reads CLAUDE.md and package.json by default. It reads README.md, CHANGELOG.md, or any source file only when:

  • the rough prompt names the file, or
  • the ambiguities identified in Step 2 cannot be resolved from CLAUDE.md and package.json alone.

When the narrowed default isn't enough, Step 2a's interactive check ("what should I look at?") closes the gap — at the cost of one short turn, paid only when needed.

Impact on token / context usage

  • Typical project: ~3,000–5,000 tokens saved per /refine invocation.
  • Large repo with a verbose README: savings scale linearly — can exceed 10,000 tokens per run.
  • Small project (minimal CLAUDE.md/package.json): savings are smaller but the tool is also already cheap there.

For context: refinement overhead on a 3-file reference project measured ~9,800 tokens pre-change. The same workload under v0.3.0 drops to ~5,000–6,000 tokens — still a real cost, but now proportional to what refinement actually buys (a reviewable plan before execution).

What did NOT change

  • File location: still a single markdown slash command, installed at ~/.claude/commands/refine.md (global) or <project>/.claude/commands/refine.md (project-scoped).
  • Argument parsing, mode templates (47 / 46), style rules, Step 2 / 2a / 3 / 4 logic, conventions section, install steps, frontmatter — all unchanged.
  • One file, no dependencies, no build step.

Also in this release

  • README.md "How it works" step 1 updated to reflect the narrower default.
  • README release badge bumped to v0.3.0.

Upgrade

curl -o ~/.claude/commands/refine.md \
  https://raw.githubusercontent.com/ICJIA/claude-code-refine/main/refine.md

Restart your Claude Code session to pick up the new template.

Full changelog: https://github.com/ICJIA/claude-code-refine/blob/main/CHANGELOG.md
Compare: v0.2.0...v0.3.0

Assets 2
Loading