<p align="center">
  <img src="assets/logos/logo-stack-monochrome.svg" alt="My Agent Kit Logo" width="120" />
  <h1 align="center">My Agent Kit</h1>
  <p align="center">
    AI coding agent kit — 14 agents, 90+ skills, 20+ hooks, structured workflows.
    <br />
    <a href="https://phuc-nt.github.io/my-agent-kit-docs/">Documentation</a>
    &middot;
    <a href="https://phuc-nt.github.io/my-agent-kit-docs/guides/">Workflow Guides</a>
    &middot;
    <a href="https://www.npmjs.com/package/my-agent-kit">npm</a>
    &middot;
    <a href="https://github.com/phuc-nt/my-agent-kit/issues">Report Bug</a>
  </p>
</p>

<p align="center">
  <a href="https://www.npmjs.com/package/my-agent-kit"><img src="https://img.shields.io/npm/v/my-agent-kit?color=blue" alt="npm version" /></a>
  <a href="https://www.npmjs.com/package/my-agent-kit"><img src="https://img.shields.io/npm/dm/my-agent-kit" alt="npm downloads" /></a>
  <a href="https://github.com/phuc-nt/my-agent-kit/blob/main/LICENSE"><img src="https://img.shields.io/github/license/phuc-nt/my-agent-kit" alt="license" /></a>
</p>

---

Built for **Claude Code**, with cross-tool support for GitHub Copilot, Codex CLI, Cursor, Windsurf, and others.

## Why

Claude Code out of the box has no memory across sessions, no structured workflows, and no domain knowledge. You end up re-explaining the same things every time.

My Agent Kit fixes this by layering **agents** (specialist roles), **skills** (domain knowledge), **hooks** (automation), and **rules** (workflow enforcement) on top — all as plain files, no magic.

## Install

```bash
npx my-agent-kit init
```

Run inside your project directory. Add `--all` for Copilot + Codex support. See [full install guide](https://phuc-nt.github.io/my-agent-kit-docs/) for options and post-setup steps.

## Quick Start

```bash
cd your-project && claude
```

```
/mk:cook "add user authentication with Google OAuth"
```

The kit handles the rest: plan → implement → test → review → ready to ship.

See [all commands](https://phuc-nt.github.io/my-agent-kit-docs/#các-lệnh-hay-dùng) and [workflow guides by project type](https://phuc-nt.github.io/my-agent-kit-docs/guides/) (CLI tool, Web full-stack, Infra/DevOps, plus an invariant core that covers ~90% of projects).

## What's Inside

| Component | Count | What |
|---|---|---|
| **Agents** | 14 | planner, tester, code-reviewer, debugger, researcher, fullstack-developer, code-simplifier, journal-writer, and more |
| **Skills** | 90+ | frontend, backend, databases, DevOps, design, AI/ML, testing, security, documents, deployment, plus: `chrome-profile`, `agentize`, `cti-expert`, `excalidraw`, `graphify`, `show-off`, `xia` |
| **Hooks** | 20+ | Session context injection, dev rules enforcement, privacy protection, signal-driven simplify gate, state tracking, **workflow artifact gate** (opt-in) |
| **Rules** | 7 | Workflow, development standards, orchestration, documentation, team coordination, skill domain routing, skill workflow routing |

## What's new in 2.1.0

The **workflow artifact gate** turns `mk:cook` / `mk:fix` review into a file-backed contract: 5 JSON artifacts (`context-snippets`, `risk-gate`, `verification`, `review-decision`, `adversarial-validation`) must validate before any finalize / commit / ship / push / PR / deploy action. Auto mode now stops on high-risk diffs (auth, payments, DB schema, CI/deploy, destructive FS ops). Score `>= 9.5` is now only a confidence signal — never sufficient for approval on its own.

Opt-in per project via `.claude/.mk.json`:

```json
{ "hooks": { "workflow-artifact-gate": true } }
```

See [CHANGELOG](CHANGELOG.md#210---2026-05-26) for the full list.

## Cross-Tool Support

| Tool | Support |
|---|---|
| **Claude Code** | Full — `CLAUDE.md` + `.claude/` |
| **GitHub Copilot** | Full — reads `.claude/` natively (VS Code 1.108+) |
| **Codex CLI** | Good — `AGENTS.md` + `.agents/skills/` symlink |
| **Cursor / Windsurf** | Basic — reads `AGENTS.md` |

## Documentation

- **[Installation & Setup](https://phuc-nt.github.io/my-agent-kit-docs/)** — Install, configure, customize, tips
- **[Workflow Guides](https://phuc-nt.github.io/my-agent-kit-docs/guides/)** — 33 real-world workflows by role

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md).

## License

[MIT](LICENSE)
