Changelog
All notable changes to Claude Code Kit.
All notable changes to Claude Code Kit are documented in this file.
This changelog is generated by release-please from Conventional Commits; the project adheres to Semantic Versioning.
1.20.0 (2026-06-07)
Features
1.19.0 (2026-06-07)
Features
- kit additions — observability, MCP governance, cross-tool export, command manifest (#172) (227d875)
- skills: add /capabilities onboarding briefing skill (#169) (dffaa82)
Bug Fixes
1.18.0 (2026-06-07)
Features
- hooks: restore context after compaction via source-aware session-start (#165) (1154b8e)
- skills: router-style descriptions + web-read skill (#164) (cbd4251)
1.17.2 (2026-06-03)
Bug Fixes
- hooks: harden json-parse.sh against field-name code injection (#158) (42c04f3)
- hooks: align jq path with python in json-parse.sh (#160) (7fbeffb)
1.17.1 (2026-06-02)
Bug Fixes
1.17.0 (2026-05-28)
Features
- harden safety hooks + add stack templates, cck skills, macOS/install CI (CLA-53–73) (8ae494b)
1.16.1 (2026-05-25)
Bug Fixes
- kit audit — stop-gate staleness, fail-closed hooks, protect-changes scoping, docs accuracy (#151) (046ba68)
1.16.0 (2026-05-25)
Features
1.15.0 (2026-05-25)
Features
1.14.0 (2026-05-22)
Features
- 4 Karpathy 12-rule gaps + role-bound model rule + dirty-tree session signal (#138) (b2a6c8c)
- lesson-resurface helper script + bench coverage + vocabulary clarity (#141) (ccf0415)
- plugin: publish kit as Claude Code plugin marketplace listing (#136) (5c0da70)
- skills: /lesson-resurface — surface dormant lessons by topic, pointers-only (#139) (98386e5)
- skills: /note — mid-session across-compaction memory (DFMT spike build) (#142) (acd667d)
1.13.0 (2026-05-20)
Features
1.12.0 (2026-05-19)
Features
- auto-publish to npm when release-please cuts a release (#94) (968dc0e)
- extensions: .claude/extensions/ slot + collision warning (#130) (#130) (72c599f)
- skills: /constitution — author golden-principles.yaml interactively (#128) (#128) (4b27d57)
- skills: /tasks-to-linear — sync agent TaskList → Linear issues (#127) (4281ab8)
Bug Fixes
1.11.0 (2026-05-18)
Features
- bench: KitBench — reproducible eval harness for the kit's claims (#120) (f5fbd71)
- docs: add explicit Match Existing Style rule to Scope Discipline (#122) (6c610b8)
- docs: add Goal-Driven Task Reframing pattern (#121) (f0e84c5)
- hooks: add bash-budget PostToolUse hook for context-cost observability (#117) (e2f02ec)
- hooks: session scorecards — schema_version 2 metrics in session-end audit (#119) (a7d1eb5)
- lessons: typed-relation graph with auto-generated index sections (#118) (8bb402e)
- plugin: publish Claude Code plugin marketplace scaffold (#123) (adb04a3)
- skills: /harness-init — scaffold OpenAI-style docs/ structure (#124) (d82ab7d)
- skills: /quality-audit + /doc-gardening — golden-principles drift detection (#125) (da13b90)
- skills: /references-sync — sync llms.txt dependency refs into docs/references/ (#126) (cf752ee)
- skills: adopt Core Rule + Default Behavior + Phase 1 Inventory patterns (#112) (8b93267)
1.10.0 (2026-05-16)
Features
1.9.0 (2026-05-12)
⚠ BREAKING CHANGES
- tasks/lessons.md is replaced by tasks/lessons/. Existing installs on --upgrade keep their legacy lessons.md and receive a migration hint; run scripts/migrate-lessons.sh to convert.
Features
1.8.0 (2026-05-11)
Features
- add HTML artifacts module (--html flag) (#95) (1b61831)
- html: integrate HTML module into uninstall, doctor, and ARTIFACTS (#97) (815f38b)
1.7.3 (2026-04-26)
Bug Fixes
1.7.2 (2026-04-26)
Bug Fixes
- remove exports/ phantom dir, sync data flow with tiered boot, complete manifest (451bfde)
- remove exports/ phantom dir, sync data flow with tiered boot, complete manifest (375d1fc)
1.7.1 (2026-04-26)
Miscellaneous Chores
- bundle 1.7.0 follow-ups into a 1.7.1 release (fe465b4)
1.7.0 (2026-04-26)
Features
- add deepening-review and interface-design skills (69dd199)
- add deepening-review and interface-design skills (bbbea59)
Bug Fixes
- replace underscore italics with asterisks in architecture-language.md (8d234e3)
1.6.3 (2026-04-14)
Bug Fixes
- remove all editor-specific branding from wiki module (e5b5031)
- remove editor-specific branding from wiki module (fa4adab)
1.6.2 (2026-04-14)
Bug Fixes
- isolate wiki module and rename flag to --wiki (99350e4)
- isolate wiki module and rename flag to --wiki (097e8e9)
1.6.1 (2026-04-14)
Bug Fixes
1.6.0 (2026-04-14)
Features
- add optional knowledge wiki module (--wiki) (0392138)
Bug Fixes
- add language specifiers to fenced code blocks (MD040) (158c7a8)
- sync package.json version and add to release-please (9c082a3)
- sync package.json version to 1.5.1 and add to release-please (8cebb61)
1.5.1 (2026-04-07)
Bug Fixes
- npm publish setup — scoped package name, Node.js bin wrapper (fd3cb6e)
- npm publish setup — scoped package, Node.js bin wrapper (e01e81d)
1.5.0 (2026-04-07)
Features
- add AGENTS.md generation for cross-tool compatibility (7c69b55), closes #65
- add npx distribution support (2c5e493), closes #67
- tiered session boot to reduce token overhead at startup (71ded9d), closes #66
- v1.5.0 — security fixes, AGENTS.md, tiered boot, npx distribution (9495e27)
Bug Fixes
- remove trailing blank lines from generated AGENTS.md (6f76942)
- resolve security and reliability findings (#61, #62, #63, #64) (384c1ae)
1.4.1 (2026-04-05)
Bug Fixes
- add hook profile reference table to hooks.md (a95f083), closes #57
- create missing .kit-manifest for upgrade tracking (934d955), closes #56
- document exports/ as generated directory in CODEBASE_MAP.md (9c2040e), closes #58
- exclude code blocks from placeholder detection in validate-skills.sh (5c37d37), closes #59
- extract shared JSON parsing into hooks/lib/json-parse.sh (d73203c), closes #55
- resolve audit findings — JSON lib, manifest, profile docs, validation (def859a)
1.4.0 (2026-04-05)
Features
- add severity labels (Critical/Major/Nit/FYI) to code-reviewer agent output (#51)
- add anti-rationalization tables to 5 skills: debug, code-quality-audit, ship, architecture-review, testing-audit (#50)
- add language-aware error patterns (Python, TypeScript, Go, Rust) to debug skill (#48)
- add code-review-graph MCP conditional integration to code-reviewer agent (#49)
- add DESIGN.md template for frontend design systems — 9-section format, CLAUDE.md integration, design-review skill update (#42)
- add timestamped feature spec folders and
/shape-specskill for multi-session feature planning (#43) - add why-loop to skill extraction workflow — clarifying questions before documenting skills (#44)
- add structured product context templates: mission.md, tech-stack.md, roadmap.md under agent_docs/project/ (#45)
- add observer loop detection hook (loop-detect.sh) — warns at 4 edits, blocks at 6 to the same file (#47)
Bug Fixes
- fix strict profile PostToolUse matcher to include NotebookEdit (#46)
- extract shared JSON parsing into
.claude/hooks/lib/json-parse.sh— removes duplication across 10 hooks (#55) - create missing
.kit-manifestfile for upgrade tracking (#56) - add hook profile reference table (minimal/standard/strict) to hooks.md (#57)
- create missing
exports/directory referenced in CODEBASE_MAP.md (#58) - fix validate-skills.sh false-positive placeholder warnings on code blocks and inline code (#59)
1.3.2 (2026-03-28)
Features
- add Glassworm invisible Unicode detection hook (
unicode-scan.sh) — defends against supply chain attacks using invisible characters (#32) - add template-based skill generation system — shared blocks,
.tmpltemplates, andbuild-skills.shbuild script (#29) - convert 3 skills to templates as proof-of-concept (code-quality-audit, testing-audit, dead-code-audit)
- add 6 shared content blocks: preamble, scope-rules, verification-order, plan-first, context-gathering, report-footer
Bug Fixes
- close #30 (retro skill) and #31 (office-hours skill) — already implemented in v1.3.0
- fix build-skills.sh race condition with /tmp file — use mktemp instead (#36)
- fix validate-skills.sh and gen-skill-docs.sh false failures on _shared/ and _templates/ dirs (#37)
- fix install.sh agent count message, add missing gitignore entry, fix hooks.md matcher (#38)
- add python3 pre-flight check to build-skills.sh, improve unicode-scan.sh readability (#39)
1.3.1 (2026-03-23)
Bug Fixes
- resolve doc inconsistencies and harden scripts (87614bb)
- resolve doc inconsistencies, add project overlay dirs, harden scripts (4abcceb)
1.3.0 (2026-03-19)
Features
Bug Fixes
1.2.1 (2026-03-13)
Bug Fixes
- add --repo flag to gh workflow dispatch in release CI (#21) (f5d9a11)
- auto-trigger CI checks on release-please PRs (#19) (27f47fa)
- report commit statuses on release PR head SHA (#22) (1ea0de2)
1.2.0 (2026-03-13)
Features
- add 7 skill writing principles to skills guide (#16) (88bcab8)
- add skill validator script with doctor.sh integration (#13) (e737e3d)
- add skill-compliance hook for post-edit skill verification (#15) (591ca30)
- add skill-generator meta-skill for project-specific coding standards (#14) (fc28b89)
- extended skill folder structure (#12) (cc6e59d)
Bug Fixes
- align Three-Agent Pattern ASCII art diagram (#17) (75d675f)
- harden shell scripts for robustness and edge cases (#11) (d6cb48c)
- sync VERSION with release and fix release-please config (#9) (f6b2124)
1.1.0 (2026-03-12)
Features
- add --diff flag to install.sh and clean up README (bab00a2)
- add agent docs, stack templates, validation, and install script (7a1880c)
- add agent frontmatter, QA reviewer agent, and multi-tool export script (b949b89)
- add agent frontmatter, QA reviewer, and multi-tool export (854e16a)
- add custom agent definitions (security-reviewer, code-reviewer, planner) (a44d115)
- add GitHub Pages with Cayman theme (2b5ea76)
- add hooks system with 7 pre-built hooks (e3c8db9)
- add install profiles, upgrade mode, and doctor command (7b28869)
- add project logo to README (c58e1db)
- add project logo to README and assets (425ccaa)
- add session handoff, decisions, statusline, permissions, conventional commits (a2667b1)
- add uninstall script and --gitignore flag (964214f)
- add uninstall script and --gitignore flag for private installations (c56787b)
- enhance documentation with new sections on task contracts, context management, and agent behavior strategies (283dd47)
- implement skill extraction system with reminder hook and documentation (b09627c)
- remove GitHub Pages, add semantic versioning (#4) (3f69401)
Bug Fixes
- add workflow_dispatch trigger to release workflow (#5) (65899e9)
- address 6 bugs and inconsistencies from review (b4e9d26)
- correct license year and author name (4fe436d)
- exclude CHANGELOG.md from markdown lint (#8) (30fc0ad)
- harden shell scripts and align hook documentation (91c9bdf)
- make install.sh upgrade pick up new scripts and agents automatically (3344ead)
- remove invalid extra-files param from release workflow (#7) (8a3fe77)
- remove trailing blank line in todo.md (MD012) (2764bed)
- update Markdown code blocks for consistency across documentation (563b707)
- use remote_theme for GitHub Pages cayman theme (73b2067)
- wire decisions.md into session boot and protected changes workflow (0e0014b)