Skip to content

quiet positioning: README pivot + fixed-context dedup (budget re-frozen at 4580) - #17

Merged
chipfighter merged 4 commits into
mainfrom
docs/quiet-positioning
Jul 17, 2026
Merged

chipfighter merged 4 commits into
mainfrom
docs/quiet-positioning

Conversation

@chipfighter

@chipfighter chipfighter commented Jul 17, 2026 •

Copy link
Copy Markdown
Owner

What

Two-part scope, one campaign — say the positioning and be it:

1. README pivot (both languages): intervention frequency, not "lighter".
Measured fixed injection against superpowers v6.1.1 with symmetric rules
(everything the SessionStart hook injects + skill metadata the host loads;
bodies excluded on both sides). Result is a near-tie, so the README now
leads with the honest claim: fixed cost is a wash; the differentiator is
how often a plugin inserts itself and what it spawns when it does.
Reproducible via experiments/context-measure/measure_fixed_context.py.

2. Fixed-context dedup (Tier A only — pure duplication, no
trigger-semantics change):

  • primer: drop the "Do not merely read SKILL.md" paragraph (hook already
    appends a host-specific invocation note) and the human-facing H1
    parenthetical
  • git-flow description: drop the project-guide deference clause (covered
    by the primer's global precedence rule + the skill body)
  • systematic-debugging description: drop the emergency-containment
    sentence (covered verbatim by the body's hard rule)
  • hook: unknown-host branch now emits a generic invocation note
  • FIXED_CONTEXT_BUDGET re-frozen 4944 → 4580; CLAUDE.md boundary updated

Behavior-summary sentences in descriptions (Tier B) are deliberately NOT
trimmed: the routing surface stays stable while real users generate
trigger feedback.

Measured (2026-07-17, post-trim)

fixed injection / session coding-discipline (main) superpowers v6.1.1
SessionStart hook payload 1,474 chars 3,277 chars
skill metadata 3,392 chars (8 skills) 2,279 chars (14 skills)
total 4,866 (~1.2k tokens) 5,556 (~1.4k tokens)

Evidence

  • tests/test-plugin-metadata.py passes (budget 4580 is an exact fit)
  • tests/test-hooks.sh passes (bash suite)
  • tests/test-windows-hook.ps1 passes
  • unknown-host fallback manually driven: valid JSON, fallback note
    present, removed sentence gone

Left before merge

  • record the two ~30s demo clips and replace the README TODO block
  • suggested release after merge: tag v0.8.1 (owner decides)

🤖 Generated with Claude Code

chipfighter and others added 4 commits July 17, 2026 12:43
Measures the per-session fixed context (SessionStart hook payload + skill
metadata) of coding-discipline and superpowers with symmetric rules, so the
README comparison table can be reproduced by anyone.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…d-cost table

Measured against superpowers v6.1.1 (post its v6.1.0 bootstrap trim), fixed
injection is a tie: 5,230 vs 5,556 chars (~1.3k tokens each). Drop the
implied "lighter" angle; state that the difference is how often the plugin
intervenes and that interventions add no subagents, plan files, or
artifacts. Adds the measured table with a reproduction link and a commented
placeholder for two demo clips. Mirrored in README.zh-CN.md.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Remove four pure duplications from the fixed injection (Tier A only, no
trigger-semantics change):

- primer: drop the "Do not merely read SKILL.md" paragraph (the hook
  already appends a host-specific invocation note on both supported
  hosts) and the human-facing H1 parenthetical
- git-flow description: drop the project-guide deference clause (covered
  by the primer's global precedence rule and the skill body)
- systematic-debugging description: drop the emergency-containment
  sentence (covered verbatim by the skill body's hard rule)

Give the hook's unknown-host branch a generic invocation note so exotic
hosts keep the guidance the primer sentence used to carry. Re-freeze
FIXED_CONTEXT_BUDGET at the new 4580-character baseline (was 4944) and
update the CLAUDE.md hard boundary to match.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Post-trim measurement: hook payload 1,474 chars, skill metadata 3,392
chars, total 4,866 chars (~1.2k tokens) vs superpowers v6.1.1 at 5,556.
Label the column (main) instead of v0.8.0 since the trimmed numbers are
not the v0.8.0 release's, and reword the frozen-baseline note in both
READMEs to 4580.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@chipfighter chipfighter changed the title docs(readme): quiet-positioning pivot with measured fixed-cost table quiet positioning: README pivot + fixed-context dedup (budget re-frozen at 4580) Jul 17, 2026
@chipfighter
chipfighter merged commit 9a0fb95 into main Jul 17, 2026
2 checks passed
@chipfighter
chipfighter deleted the docs/quiet-positioning branch July 17, 2026 06:37
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.

1 participant