v4.1.0

coding agent tips v4.1.0

v4.1 turns the publication into one source-backed handbook for codex, claude code, grok, and shared coding-agent practice.

handbook

• 17 canonical routes now derive navigation, metadata, scope, sources, redirects, and update times from one content model.
• the homepage has one seven-card starting chooser, and guides is the visible shared label across desktop, mobile, sidebars, and accessibility copy.
• provider sections share overview, configuration, and recommendations while general practice, history, market context, method, and archive pages keep distinct ownership.
• responsive layouts use one mobile menu, centered tablet reading widths, a tracked table of contents, and media that stays inside the viewport.

evidence

• 46 primary-source records and 2 canonical field runs back the handbook.
• dated claims carry explicit dates, material claims keep inline citations, and each article closes with its source list.
• local copy review exposes all canonical writing surfaces and their owners without entering the production sitemap.

repository operations

• archive validation checks 11 readmes, every promised installation path, and the exact november 5, 2026 compatibility commitment.
• the required compatibility status completes on every pull request and runs the full legacy suite for archive impact, merge groups, weekly checks, and manual dispatch.
• product freshness detection remains read only. agent drafting receives no writable github credential, cannot edit recommendations, and produces a github-verified commit in a draft pull request only after canonical validation.
• manual release automation publishes only an existing reviewed draft backed by a github-verified semantic tag or the exact final archive tag.

verification

• astro checked 18 files with zero errors, warnings, or hints and built 18 static pages.
• route checks validated 17 canonical pages, redirects, links, metadata, sitemap behavior, and homepage identity.
• axe found no serious or critical issues across 17 routes at six required widths.
• markdownlint, actionlint 1.7.7, ruff, workflow yaml, shell, json, source, and field-run checks passed.
• the archived cc suite passed 45 tests and lore passed 175 tests.
• desktop and mobile browser review confirmed seven chooser cards, one production mobile menu, loaded codex media, zero overflow, and zero console warnings or errors.

compatibility

archived claude code tools and their historical installation paths remain available through november 5, 2026. the final archive tag remains legacy-tools-final-2026-11-05.

v4.0.0

coding agent tips v4.0.0

v4 rebuilds the repository as an evidence-backed guide to coding agents in
production software.

highlights

• a publication at agents.anipotts.com with dedicated codex, claude code,
  shared operating-practice, market, and hardware guides.
• a layered vocabulary that keeps surfaces, harnesses, models, and
  orchestration systems distinct.
• validated claim metadata, a source registry, beside-the-claim evidence, and
  read-only freshness checks.
• a public field lab with a reproducible protocol and an honest codex launch
  baseline.

evidence and limits

the codex guide combines current hands-on work with primary-source review. the
claude code guide is current against official documentation but remains labeled
source-verified until the paired hands-on protocol is complete. missing model,
timing, hardware, and cost measurements remain visible in the baseline rather
than being estimated.

legacy compatibility

the existing claude code plugins and hooks remain available at their historical
installation paths through 2026-11-05. they are frozen except for security,
data-loss, current compatibility, and installation blockers. the planned final
tag is legacy-tools-final-2026-11-05.

verification

the launch candidate passes astro type checking and production build, generated
route and metadata checks, field-run validation, markdown linting, source
freshness checks, 45 cc tests, and 175 lore tests. external-link validation
and github pages deployment run in github actions.

v2.1.0

v2.1.0 stabilizes the v2 session mesh and time subsystem for daily use, adds fuel (3-meter proprioception), and replaces CodeRabbit with a structured claude + codex review team. v3.0.0 (~6 weeks) will expose mine as observability-as-a-service via MCP and wire the repo to the claude code changelog within an hour of publish. see docs/rfcs/ for the shape.

what's new

cc plugin: time subsystem

• time rule at plugins/cc/rules/time.md: bimodal session modes (quick / standard / marathon), model x effort throughput matrix, 3-tier parallelism (main / subagent / agent teammate), relaxed compaction warnings for the 1M-context era
• SessionStart hook reads ~/.claude/mine.db and injects last-5-sessions-in-project timing. silent on missing db
• three skills: /cc:time-estimate, /cc:time-calibrate, /cc:time-benchmark. user-invocable: false so they stop cluttering the slash menu; still fully model-callable

cc plugin: slash ux

• plugin command renamed /cc:cc -> /cc:sessions (readable in the slash menu)
• every example in plugins/cc/README.md updated

fuel plugin (NEW, replaces the orphaned pulse@cc)

• 3-meter proprioception: 5-hour session, 7-day weekly, 200k conversation context
• pre-turn awareness hook injects threshold-aware context (80% soft warn, 90% suggest handoff, 95% dramatic intervention)
• /fuel state reads all meters; /fuel handoff drafts a clean stopping point + next-session opening prompt; /fuel quiet / /fuel loud toggle
• shipped briefly as pulse@cc v1.0.0, renamed to fuel for clearer gauge metaphor. migration note in plugins/fuel/README.md

review automation

• replaces CodeRabbit with an ai-review-team: claude-review (prose, voice, contract shape) + codex-review (bugs, security, shell/python/ci correctness). both curl-based against Anthropic / OpenAI responses apis. both read .github/AI_REVIEW_RUBRIC.md so output is consistent: blocking / apply / discuss / dismissed
• .coderabbit.yaml disables CodeRabbit auto-reviews; full uninstall via github repo settings -> integrations
• docs/review-process.md explains the contract, required secrets, how to turn reviewers off

auto-merge for autonomous PRs

• prs from @anipotts, trusted bots (dependabot, github-actions, pre-commit-ci, claude*, codex*), or autonomous branch namespaces (claude/, auto/, release/, chore/, fix/) get auto-merge enabled on open
• ci still gates the merge. red ci blocks the same way it always did
• trust list + failure modes documented at docs/auto-merge.md

translation without api keys

• translate.yml now falls back to argos-translate (fully offline pip package, CC-BY-4.0) when ANTHROPIC_API_KEY is unset
• argos helper at .github/scripts/translate_readme.py extracts prose between markdown-structural lines, translates only prose, reassembles. structural validation still runs
• claude-haiku path unchanged when key is set. commit message encodes which backend ran

docs + governance

• top-level README repositioning: subtitle anchored in where these patterns have been used (yc startups, public tech companies, unicorns). dropped star-CTA for "start here" links
• CONTRIBUTING.md, SECURITY.md, CODE_OF_CONDUCT.md
• three v3-horizon rfcs drafted

security + housekeeping

• hono dependabot alert #7 patched via transitive bump (4.12.12 -> 4.12.15)
• no u+2014 in any shipped markdown or JSON
• tested-with stamps refreshed to v2.1.118; version-stamps ci check now enforces (was informational)

breaking

• /cc:cc slash command no longer exists. use /cc:sessions. the underlying cc mcp tool is unchanged
• pulse@cc orphaned. the plugin is now fuel@cc. if you ran the old v1.0.0 pulse, rm ~/.claude/.pulse_cache ~/.claude/.pulse_quiet before first /fuel run

upgrading

claude plugin marketplace update cc
claude plugin install cc@cc --reinstall
claude plugin install mine@cc --reinstall
claude plugin install fuel@cc

v3.0.0 horizon (~6 weeks)

• mine v2 observability-as-a-service (MCP interface, billing method + feature stack + session-to-outcome mapping)
• freshness watcher with sub-hour SLA on the always-on operator machine
• tip content pass (voice + abstractable-pattern rewrites for ultrathink, session-length, fast-mode, prompt-caching)

full diff

v2.1.77...v2.1.0

thanks to CodeRabbit for the last cycle of feedback; the rubric that replaced it was shaped by what the noise looked like.

v2.1.77

what's new

commits

• 3ad7f7e docs: rewrite README with personal voice and new structure
• f7000a5 feat: add SETUP.md — 5-minute quick-start guide
• 43a4131 feat: add this-repo.md — dogfooding transparency page
• c73e175 docs: update CLAUDE.md for restructured docs layout
• e6a48a4 feat: add docs/tips/ and docs/notes/ skeleton
• 99e6711 fix: update all cross-references for new docs layout
• 95ca804 chore: remove replaced workflows
• fba9b0b refactor: update docs-audit for direct commits, retire old collector
• 357a246 feat: add weekly community-digest pipeline
• 03568e4 feat: add weekly competitive-update pipeline
• 5d76f9f feat: add official-watcher pipeline (replaces tier-1 upstream-watcher)
• a34a85b refactor: split collect_upstream.py into 3 focused scripts
• 520da76 feat: add dependabot auto-merge workflow
• 918dbef feat: add daily stale PR/branch cleanup workflow
• 1203e17 fix: remove personal path from code comments
• c91ee59 chore: update upstream watcher state
• 3a5695b chore: update upstream watcher state
• c90809f chore: update upstream watcher state
• 1f7b855 chore: update upstream watcher state
• eaf7c5e chore: update upstream watcher state
• 8533605 chore: update upstream watcher state
• acf9d5a chore: update upstream watcher state
• 7a677c5 chore: update upstream watcher state
• 6b1b739 refactor: apply agent research — README polish, marketplace cleanup
• 1dae24e chore: update all version stamps from v1.0.34 to v2.1.77
• 27d50f2 fix: update handoff plugin links to examples/plugins/ path
• 5ff5b65 docs: update CLAUDE.md to reflect restructured repo
• 9be18a8 docs: rewrite README with singular toolkit identity
• a7d98e5 refactor: remove dead weight commands, move demo plugins to examples
• 98cbde6 docs: update CLAUDE.md with tier 2-3 hooks and agents
• 19054df feat: add commit-nudge hook for uncommitted change reminders
• acac0a9 feat: add changelog-writer and link-checker agents
• aec9b2e feat: add plugin smoke test workflow
• 9fce79f feat: add release workflow with auto version bump and changelog
• 587b7b7 feat: add tier 1 automation hooks
• 67a8188 docs: update CLAUDE.md with handoffs gitignore and new hooks
• 19be3db chore: gitignore handoffs/ and remove from tracking
• b9d824f docs: add automation recommendations for repo and anipotts.com
• f6bab66 fix: remove last extra blank line in pricing.md
• 0099ea6 chore: add version stamps to mine plugin scripts
• b75c2c7 fix: broken links and stale references in docs
• 1990104 chore(deps): bump DavidAnson/markdownlint-cli2-action
• a012e63 docs: add course platform handoff prompt for anipotts.com
• 6b43454 chore: bump actions to Node.js 24 — checkout v6, setup-python v6, markdownlint v20
• 0a00903 fix: add API key guards to docs-audit and comparison-update
• 39ec5ef fix: upstream watcher — auto-clean stale branches, use merge not squash
• 404a1d3 fix: harden autonomous workflows — labels, paths, dependabot
• 5e9ce0b fix: remove cache: pip from workflows without requirements.txt
• e977271 fix: remove trailing comma in plugin.json
• 132059e dx: add CI badge, changelog, improve README
• 5488a9d CI: concurrency groups, scoped secrets, dependabot, tool restrictions
• 9e95ae9 fix: stale branding, unused code, version sync, deprecated tempfile
• 72f04af mine: harden hooks — busy timeout, TOCTOU fix, dependency checks
• 39b2b12 fix: command injection in osascript, webhooks, and panopticon
• b602adc add monetization research handoff
• b94dcf4 add course structure handoff
• ea72e65 add /dashboard command + expand replay to capture bash calls
• 9768d55 add handoff prompts
• 4bdfc1e update commands, agents, CI for mine rename + fix broken paths
• 6a76876 docs: refresh comparisons, guide, cost analysis, troubleshooting
• 1232667 add mine.py test suite
• 1abe921 add replay capture hook
• 9cb811d add live session dashboard
• 795b839 mine: update marketplace manifests
• 4a623ad mine: update parser with user-centric metrics
• 7e82cb4 mine: add burn cost-anomaly hook
• 045f001 mine: rename scar→mistakes, remove gauge
• bbe7e55 mine: rename plugin miner→mine
• 02c2f2e chore: update upstream watcher state
• b74b5c7 chore: update upstream watcher state
• 1fe2a31 chore: update upstream watcher state
• c26a96e chore: update upstream watcher state
• 346727b upstream: tier 1 changes 2026-03-13 (#3)
• 32156b9 chore: update upstream watcher state
• 58b781f chore: update upstream watcher state
• 998a0d6 chore: update upstream watcher state
• 9237d7b chore: update upstream watcher state
• abeb3b8 chore: update upstream watcher state
• 35d43c4 chore: update upstream watcher state
• fefb168 chore: update upstream watcher state
• e49c944 chore: update upstream watcher state
• c885ffe chore: update upstream watcher state
• e16b996 miner: plan-aware prompts with user-centric query filtering
• 4bf42d7 miner: user-centric metrics in schema views and mine.py --stats
• 7333ebe miner: self-healing pipeline + single-output dashboard
• 9b917d2 restructure for claude-native auto-discovery
• 544a38d Revise README for clarity and repo purpose
• 668400d update marketplace: miner v1.0.0 with homepage and license
• 38fbd9a restructure miner plugin for marketplace distribution
• 2613bb3 consolidate /sift, /ledger, /value into /miner
• b28495c fix: broken code fences in skill prompts
• fb6c70a overhaul: living reference hub — CI, comparisons, workflows, docs audit
• 346149b chore: update upstream watcher state
• 0e49bf1 chore: update upstream watcher state
• 1b7d823 remove GIF embeds from all READMEs except hero image
• 73caf07 chore: update upstream watcher state
• 9590146 fix haiku model ID in draft generator
• 7cd0e70 chore: update upstream watcher state
• 4311075 improve upstream collector: raw CHANGELOG.md, add marckrenn tracker
• f953193 add contributing guide
• f13ec21 add issue templates, funding config
• d2128c3 add upstream watcher workflow + quick-merge from phone
• 96e200c add SMS/push notification script
• e0b09fc add Haiku-powered draft content generator
• 2816166 add upstream change collector script
• 051b8ae add example CLAUDE.md starter templates
• cd24659 add cost analysis guide
• 79d5c9f add agent teams guide
• 29ec620 add HTTP hooks, new env vars to hooks guide
• a3a86e6 gitignore audit and internal analysis files
• 7f011cb expand audit with 9 more missing features and business context
• 1f2136b add granular 2-week release data (v2.1.51-v2.1.71) to audit
• b169ba8 add comprehensive repo audit and reorganization proposal
• 4854563 Record 6 demo GIFs and embed in READMEs at 100% width
• 06dc4b2 Polish: /ledger project mode, hooks/scripts READMEs, VHS tape files
• 20e69a6 Polish: rename rudy-notify, rewrite README, clean up repo
• e98010d Fix cost calculations, add convenience VIEWs, enrich --stats output
• 26e6c3d Miner plugin + mining system + comprehensive guide + tips
• 2dcf51a Fix typo in README description
• c8c4721 Clarify descriptions in README for plugins and skills
• b61bc96 claude-code-tips: plugins, hooks, agents, docs, and marketplace