agent-kit
Getting started

Upgrade and uninstall

Keep a project on the latest kit, or remove the kit and keep your content.

A release reaches projects in two parts: the plugin (skills, hooks, scripts) and the project files (managed blocks, stack skill, new questions).

Upgrade

Update the plugin

Claude Code
/plugin marketplace update agent-kit

Update the project files

Terminal
npx @razcue/agent-kit upgrade

agent-kit upgrade asks only the questions your project hasn't answered yet, re-applies the agent layer with your saved answers, backs up every file it changes and prints what's new since your project's kitVersion.

When the installed plugin is newer than the project's setup, the session suggests agent-kit upgrade once.

What an upgrade may move

  • 0.13: spec-lane folders moved from work/specs/NNN-slug/ to work/changes/NNN-slug/ (untouched; their NNN/AC-n test names keep working). work/specs/ now holds living specs. The QA questions are asked.

Uninstall

Terminal
npx @razcue/agent-kit uninstall --dry-run   # see what would change
npx @razcue/agent-kit uninstall

agent-kit uninstall removes the managed AGENTS.md block, agent-kit's entries in .claude/settings.json, the stack skill and agent-kit.json — each backed up in .agent-kit/backups/. Your .knowledge/, work/, scripts/ and commit tooling stay.

Project layout

Every file and folder agent-kit adds to a project, and what each one is for.

Channels

Where agent-kit is published — documentation, docs MCP server, Claude Code plugin, npm CLI — and how they fit together.