# @evolvconsulting/evolv-coder-kit

> **Version 0.8.2** — v0.8.x LTS

Claude Code infrastructure templates for full-stack projects — agents, skills, hooks, primitives.

## Prerequisites

### macOS

- **Node.js** >= 22.0.0
- **Claude Code CLI** ([install](https://docs.anthropic.com/en/docs/claude-code/overview))
- **GitHub CLI** (`gh`) ([install](https://cli.github.com/))

### Windows

All steps run inside WSL2:

- **WSL2** with a Linux distribution installed
- **Node.js** >= 22.0.0
- **Claude Code CLI** ([install](https://docs.anthropic.com/en/docs/claude-code/overview))
- **GitHub CLI** (`gh`) ([install](https://cli.github.com/))

## Install

```bash
npm install -g @evolvconsulting/evolv-coder-kit
evolv-coder-kit
```

The first command installs the binary. The second runs an interactive setup wizard that configures your preferences and deploys all infrastructure to `~/.claude/`.

## After Install

Open Claude Code and use:

- `/eck:help` — see all available commands
- `/eck:new-project` — scaffold a new project with full infrastructure
- Core loop: `/eck:spec` → `/eck:design` → `/eck:develop` → `/eck:validate` → `/eck:deploy`

## Upgrading

```bash
npm install -g @evolvconsulting/evolv-coder-kit
evolv-coder-kit
```

Re-running `evolv-coder-kit` upgrades in place — existing files are updated only when the source has changed. Use `evolv-coder-kit --configure` to re-run the setup wizard.

## What Gets Installed

**Global** (`~/.claude/`) — slash-command skills including 5 core loop orchestrators, compiled hooks (statusline, context monitor, update checker), output modes, and the full project template catalog.

**Per-Project** (`./.claude/`) — agents, sub-skills, hooks, primitives, and coding standards. Deployed via `/eck:new-project`.

## Documentation

Documentation lives in the [evolv-coder-kit-dev](https://github.com/evolvconsulting/evolv-coder-kit-dev) repo:

| Guide                                                                                                   | Audience     | Description                                                              |
| ------------------------------------------------------------------------------------------------------- | ------------ | ------------------------------------------------------------------------ |
| [User Guide](https://github.com/evolvconsulting/evolv-coder-kit-dev/blob/dev/docs/guides/USER-GUIDE.md) | Users        | Skill reference, architecture, installation options, troubleshooting     |
| [Dev Guide](https://github.com/evolvconsulting/evolv-coder-kit-dev/blob/dev/docs/guides/DEV-GUIDE.md)   | Contributors | Package architecture, adding skills/migrations, testing, release process |
| [Release Notes](https://github.com/evolvconsulting/evolv-coder-kit-dev/blob/dev/RELEASE-NOTES.md)       | Users        | What's new in each version                                               |
| [Changelog](https://github.com/evolvconsulting/evolv-coder-kit-dev/blob/dev/CHANGELOG.md)               | Contributors | Detailed technical changes with issue/commit references                  |
| [Glossary](https://github.com/evolvconsulting/evolv-coder-kit-dev/blob/dev/docs/guides/GLOSSARY.md)     | All          | Canonical definitions for catalog, component, skill, hook, primitive     |

## Contributing

See [CONTRIBUTING.md](https://github.com/evolvconsulting/evolv-coder-kit-dev/blob/dev/docs/guides/CONTRIBUTING.md) in the dev repo.

## License

MIT
