# agent-kit

> A minimal harness for agent-driven development with Claude Code: an npx CLI (npx @razcue/agent-kit init) that sets up a project from fixed questions, and a plugin (/plugin install agent-kit --marketplace razcue/agent-kit) with skills, hooks, living specs, QA and scoped knowledge. MCP server for these docs: https://razcue-agent-kit.vercel.app/mcp

## Overview

- [agent-kit](https://razcue.github.io/agent-kit/raw/index.md)

## Documentation Sets

- [agent-kit](https://razcue.github.io/agent-kit/llms-full.txt)

## Overview

- [/en](https://razcue.github.io/agent-kit/raw/en.md)

## Documentation

- [Guardrails](https://razcue.github.io/agent-kit/raw/en/concepts/guardrails.md): Hooks and checks that enforce the rules instead of asking for them.
- [Knowledge](https://razcue.github.io/agent-kit/raw/en/concepts/knowledge.md): Facts and decisions in small files, scoped to the project, the machine or every project — only summaries load.
- [Lanes and methods](https://razcue.github.io/agent-kit/raw/en/concepts/lanes-and-methods.md): Every request goes through one of three lanes; the method decides how much proof a change needs.
- [Living specs and changes](https://razcue.github.io/agent-kit/raw/en/concepts/living-specs.md): Spec-anchored SDD — living specs are the source of truth, changes carry deltas that merge into them.
- [Notation](https://razcue.github.io/agent-kit/raw/en/concepts/notation.md): One standard notation at every step — EARS requirements, Given/When/Then scenarios, ZOMBIES tags, scenario ids in test names.
- [QA and test data](https://razcue.github.io/agent-kit/raw/en/concepts/qa-and-test-data.md): A QA checklist generated from the living specs, dated QA runs, and Supabase test data that can't touch production.
- [Scripts](https://razcue.github.io/agent-kit/raw/en/concepts/scripts.md): A registry so agents search, keep, document and test scripts instead of rewriting them.
- [How the kit improves](https://razcue.github.io/agent-kit/raw/en/concepts/self-improvement.md): From projects to the kit and back — retros, proposals, the weekly scout, releases.
- [Session context](https://razcue.github.io/agent-kit/raw/en/concepts/session-context.md): What every session starts with, how work resumes, and how the context budget is kept.
- [Channels](https://razcue.github.io/agent-kit/raw/en/getting-started/channels.md): Where agent-kit is published — documentation, docs MCP server, Claude Code plugin, npm CLI — and how they fit together.
- [Installation](https://razcue.github.io/agent-kit/raw/en/getting-started/installation.md): Set up a new or existing project, install the plugin, and check the result.
- [Introduction](https://razcue.github.io/agent-kit/raw/en/getting-started/introduction.md): What agent-kit is, what it is not, and the problems it solves.
- [Project layout](https://razcue.github.io/agent-kit/raw/en/getting-started/project-layout.md): Every file and folder agent-kit adds to a project, and what each one is for.
- [Upgrade and uninstall](https://razcue.github.io/agent-kit/raw/en/getting-started/upgrade-uninstall.md): Keep a project on the latest kit, or remove the kit and keep your content.
- [Adopt an existing project](https://razcue.github.io/agent-kit/raw/en/guides/adopt-existing-project.md): Add the agent layer to a repository you already have, shrink its AGENTS.md and bootstrap living specs.
- [Your website with Claude](https://razcue.github.io/agent-kit/raw/en/guides/content-site.md): A quick guide for non-programmers — build and change a content site by talking to Claude.
- [Docs for agents](https://razcue.github.io/agent-kit/raw/en/guides/docs-for-agents.md): Let your agent read these docs — llms.txt, llms-full.txt and the MCP server.
- [A fast-track change](https://razcue.github.io/agent-kit/raw/en/guides/fast-track-change.md): Small changes with a feature file, evidence, and the living spec kept true.
- [New app monorepo](https://razcue.github.io/agent-kit/raw/en/guides/new-app-monorepo.md): From an empty folder to a Nuxt + Supabase monorepo with the agent layer, auth starter and first change.
- [Proposing improvements](https://razcue.github.io/agent-kit/raw/en/guides/proposing-improvements.md): Send what you learned in a project back to the kit.
- [A QA pass](https://razcue.github.io/agent-kit/raw/en/guides/qa-pass.md): Test the whole product against the living specs and record the results.
- [Releasing and upgrading](https://razcue.github.io/agent-kit/raw/en/guides/releasing-and-upgrading.md): Ship a kit release and bring projects up to date.
- [A change, end to end](https://razcue.github.io/agent-kit/raw/en/guides/spec-lane-change.md): The spec lane step by step — proposal, delta specs, approval, test-first tasks, verification, merge.
- [The TDD loop](https://razcue.github.io/agent-kit/raw/en/guides/tdd-loop.md): Red, green, refactor — one behaviour at a time, cases from the scenarios and ZOMBIES.
- [Test data](https://razcue.github.io/agent-kit/raw/en/guides/test-data.md): Write fixtures per scenario, and seed or purge them safely on dev, test and staging databases.
- [Changelog](https://razcue.github.io/agent-kit/raw/en/reference/changelog.md): What changed in every version.
- [CLI](https://razcue.github.io/agent-kit/raw/en/reference/cli.md): Every agent-kit command and flag.
- [Configuration](https://razcue.github.io/agent-kit/raw/en/reference/configuration.md): Every field of agent-kit.json.
- [Hooks](https://razcue.github.io/agent-kit/raw/en/reference/hooks.md): The plugin hooks and what they enforce.
- [Privacy](https://razcue.github.io/agent-kit/raw/en/reference/privacy.md): What agent-kit's plugin, CLI, documentation site and docs MCP server collect and send — in short, nothing about you or your project.
- [Scripts](https://razcue.github.io/agent-kit/raw/en/reference/scripts.md): The zero-dependency plugin scripts and their commands.
- [Skills](https://razcue.github.io/agent-kit/raw/en/reference/skills.md): Every skill and when it loads.
- [Templates](https://razcue.github.io/agent-kit/raw/en/reference/templates.md): What each setup kind scaffolds.