bigpowers 2.45.2 → 2.45.3

package/.pi/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bigpowers",
-  "version": "2.45.2",
+  "version": "2.45.3",
   "description": "72 skills — 72 agent skills synthesizing 17 years of software engineering discipline into a prescriptive methodology for solo developers",
   "keywords": [
     "pi-package"

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+## [2.45.3](https://github.com/danielvm-git/bigpowers/compare/v2.45.2...v2.45.3) (2026-07-03)
+
+
+### Bug Fixes
+
+* **sync:** sync generated CLAUDE.md and opencode.json artifacts ([f018e27](https://github.com/danielvm-git/bigpowers/commit/f018e27cf71d61190bf58c1ef884e100e15a8aee))
+
 ## [2.45.2](https://github.com/danielvm-git/bigpowers/compare/v2.45.1...v2.45.2) (2026-07-03)
 
 

package/CLAUDE.md

@@ -64,3 +64,241 @@ Before any task, run this sequence — not optional:
 - Run tests after every change. Show evidence before declaring done.
 - One clarifying question beats a wrong assumption baked into 200 lines.
 - All written output (plans, specs, investigations) goes in specs/.
+
+## bts toolchain
+
+`bts` is installed. Prefer its verbs over ad-hoc shell commands.
+
+| Task | Command | Avoid |
+|------|---------|-------|
+| Search code | `bts find --print <pattern>` | grep / find / cat |
+| Interactive search | `bts find <pattern>` | manual grep pipes |
+| Compress for context | `bts compress <file>` or `cmd \| bts compress` | summarising by hand |
+| Repo map | `bts map` | listing files by hand |
+| Library docs | `bts docs <lib>` | guessing from training data |
+| Package source | `bts src <pkg>` | git clone |
+| Toolchain health | `bts doctor` | which / command -v |
+
+**Rules**
+- Search with `bts find` before opening files to locate a symbol or pattern.
+- Pipe anything > 200 lines through `bts compress` before adding to context.
+- Run `bts map` when asked for a repo overview.
+- Use `bts docs <lib>` before answering questions about library APIs.
+- If a tool is missing, say so and run `bts doctor` — do not silently substitute.
+
+<!-- BEGIN sqz-claude-guidance (auto-installed by sqz init; remove this block to disable) -->
+
+## sqz — Context Compression (READ FIRST)
+
+sqz is installed in this project. It compresses tool output so large
+files, long logs, and verbose command output cost far fewer tokens.
+There are **two ways** sqz is wired in, and you should prefer each
+one in the situations below.
+
+### Preferred tools (MCP)
+
+The `sqz-mcp` server is registered in this project's MCP config. It
+exposes three read-only tools that compress their output through the
+sqz pipeline:
+
+- **`sqz_read_file`** — read a file from disk and return a compressed
+  view. **PREFER this over the built-in `Read` tool** for any file
+  larger than ~2KB or any file you might read more than once in the
+  same session. Repeat reads return a 13-token `§ref:HASH§` reference
+  instead of the full content.
+
+- **`sqz_grep`** — search files for a literal string or regex.
+  **PREFER this over the built-in `Grep`** for anything that might
+  match more than a handful of lines. Caps at 200 matches by default;
+  raise with `max_matches` if needed.
+
+- **`sqz_list_dir`** — list a directory. Skips `.git`, `node_modules`,
+  `target`, `dist`, `build`, `vendor`, `__pycache__` so the output
+  stays focused. **PREFER this over `ls -la` via Bash** when you want
+  to see a project layout.
+
+The built-in `Read`, `Grep`, `Glob` tools remain available. Use them for:
+- Tiny config files (<1KB) where compression can't help.
+- Byte-exact reads you'll hash or diff (lockfiles, signatures).
+- Globbing (sqz has no glob tool; `Glob` is still the right choice).
+
+### Bash commands (hooked automatically)
+
+When you run a shell command through the `Bash` tool, a PreToolUse hook
+rewrites it to pipe output through `sqz compress`. This is transparent:
+you don't need to remember to add anything, but it's useful to know
+that these commands get compressed automatically:
+
+```bash
+git status           # → git status 2>&1 | sqz compress --cmd git
+cargo test           # → cargo test 2>&1 | sqz compress --cmd cargo
+docker ps            # → docker ps 2>&1 | sqz compress --cmd docker
+kubectl get pods     # → kubectl get pods 2>&1 | sqz compress --cmd kubectl
+```
+
+The rewrite is skipped for interactive commands (`vim`, `ssh`,
+`python`), compound commands (`a && b`, `a > file.txt`), and anything
+already going through sqz.
+
+### Escape hatch — when you see a `§ref:HASH§` token
+
+If tool output contains a `§ref:a1b2c3d4§` token and you need the full
+content it points at, resolve it. Three equivalent ways:
+
+- Shell: `/Users/danielvm/.local/bin/sqz expand a1b2c3d4` (or paste the whole token
+  `/Users/danielvm/.local/bin/sqz expand §ref:a1b2c3d4§`).
+- MCP tool: call `expand` with `{ "prefix": "a1b2c3d4" }`.
+- To get uncompressed output for one command: prefix it with
+  `SQZ_NO_DEDUP=1` (e.g. `SQZ_NO_DEDUP=1 git log | sqz compress`).
+
+If the compressed output is actively making the task harder (looping
+on refs, small retries replacing one big read), call the `passthrough`
+MCP tool to get raw text.
+
+### When NOT to use sqz tools
+
+- Writing or editing files — use the built-in `Write`/`Edit` tools.
+  sqz has no write tools (by design; see issue #5 follow-up).
+- Running commands interactively or in watch mode.
+- Reading very small files (<1KB) where compression can't help.
+
+<!-- END sqz-claude-guidance -->
+
+<!-- rtk-instructions v2 -->
+# RTK (Rust Token Killer) - Token-Optimized Commands
+
+## Golden Rule
+
+**Always prefix commands with `rtk`**. If RTK has a dedicated filter, it uses it. If not, it passes through unchanged. This means RTK is always safe to use.
+
+**Important**: Even in command chains with `&&`, use `rtk`:
+```bash
+# ❌ Wrong
+git add . && git commit -m "msg" && git push
+
+# ✅ Correct
+rtk git add . && rtk git commit -m "msg" && rtk git push
+```
+
+## RTK Commands by Workflow
+
+### Build & Compile (80-90% savings)
+```bash
+rtk cargo build         # Cargo build output
+rtk cargo check         # Cargo check output
+rtk cargo clippy        # Clippy warnings grouped by file (80%)
+rtk tsc                 # TypeScript errors grouped by file/code (83%)
+rtk lint                # ESLint/Biome violations grouped (84%)
+rtk prettier --check    # Files needing format only (70%)
+rtk next build          # Next.js build with route metrics (87%)
+```
+
+### Test (60-99% savings)
+```bash
+rtk cargo test          # Cargo test failures only (90%)
+rtk go test             # Go test failures only (90%)
+rtk jest                # Jest failures only (99.5%)
+rtk vitest              # Vitest failures only (99.5%)
+rtk playwright test     # Playwright failures only (94%)
+rtk pytest              # Python test failures only (90%)
+rtk rake test           # Ruby test failures only (90%)
+rtk rspec               # RSpec test failures only (60%)
+rtk test <cmd>          # Generic test wrapper - failures only
+```
+
+### Git (59-80% savings)
+```bash
+rtk git status          # Compact status
+rtk git log             # Compact log (works with all git flags)
+rtk git diff            # Compact diff (80%)
+rtk git show            # Compact show (80%)
+rtk git add             # Ultra-compact confirmations (59%)
+rtk git commit          # Ultra-compact confirmations (59%)
+rtk git push            # Ultra-compact confirmations
+rtk git pull            # Ultra-compact confirmations
+rtk git branch          # Compact branch list
+rtk git fetch           # Compact fetch
+rtk git stash           # Compact stash
+rtk git worktree        # Compact worktree
+```
+
+Note: Git passthrough works for ALL subcommands, even those not explicitly listed.
+
+### GitHub (26-87% savings)
+```bash
+rtk gh pr view <num>    # Compact PR view (87%)
+rtk gh pr checks        # Compact PR checks (79%)
+rtk gh run list         # Compact workflow runs (82%)
+rtk gh issue list       # Compact issue list (80%)
+rtk gh api              # Compact API responses (26%)
+```
+
+### JavaScript/TypeScript Tooling (70-90% savings)
+```bash
+rtk pnpm list           # Compact dependency tree (70%)
+rtk pnpm outdated       # Compact outdated packages (80%)
+rtk pnpm install        # Compact install output (90%)
+rtk npm run <script>    # Compact npm script output
+rtk npx <cmd>           # Compact npx command output
+rtk prisma              # Prisma without ASCII art (88%)
+```
+
+### Files & Search (60-75% savings)
+```bash
+rtk ls <path>           # Tree format, compact (65%)
+rtk read <file>         # Code reading with filtering (60%)
+rtk grep <pattern>      # Search grouped by file (75%). Format flags (-c, -l, -L, -o, -Z) run raw.
+rtk find <pattern>      # Find grouped by directory (70%)
+```
+
+### Analysis & Debug (70-90% savings)
+```bash
+rtk err <cmd>           # Filter errors only from any command
+rtk log <file>          # Deduplicated logs with counts
+rtk json <file>         # JSON structure without values
+rtk deps                # Dependency overview
+rtk env                 # Environment variables compact
+rtk summary <cmd>       # Smart summary of command output
+rtk diff                # Ultra-compact diffs
+```
+
+### Infrastructure (85% savings)
+```bash
+rtk docker ps           # Compact container list
+rtk docker images       # Compact image list
+rtk docker logs <c>     # Deduplicated logs
+rtk kubectl get         # Compact resource list
+rtk kubectl logs        # Deduplicated pod logs
+```
+
+### Network (65-70% savings)
+```bash
+rtk curl <url>          # Compact HTTP responses (70%)
+rtk wget <url>          # Compact download output (65%)
+```
+
+### Meta Commands
+```bash
+rtk gain                # View token savings statistics
+rtk gain --history      # View command history with savings
+rtk discover            # Analyze Claude Code sessions for missed RTK usage
+rtk proxy <cmd>         # Run command without filtering (for debugging)
+rtk init                # Add RTK instructions to CLAUDE.md
+rtk init --global       # Add RTK to ~/.claude/CLAUDE.md
+```
+
+## Token Savings Overview
+
+| Category | Commands | Typical Savings |
+|----------|----------|-----------------|
+| Tests | vitest, playwright, cargo test | 90-99% |
+| Build | next, tsc, lint, prettier | 70-87% |
+| Git | status, log, diff, add, commit | 59-80% |
+| GitHub | gh pr, gh run, gh issue | 26-87% |
+| Package Managers | pnpm, npm, npx | 70-90% |
+| Files | ls, read, grep, find | 60-75% |
+| Infrastructure | docker, kubectl | 85% |
+| Network | curl, wget | 65-70% |
+
+Overall average: **60-90% token reduction** on common development operations.
+<!-- /rtk-instructions -->

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bigpowers",
-  "version": "2.45.2",
+  "version": "2.45.3",
   "description": "72 agent skills synthesizing 17 years of software engineering discipline into a prescriptive methodology for solo developers",
   "main": "index.js",
   "scripts": {