npm package: @hd-agent-kit/cli
Description: AI agent configuration kit — sets up AGENTS.md and skill files for Claude Code, Cursor, Windsurf, and OpenCode
Latest version: 1.6.5

# @hd-agent-kit

AI agent configuration kit for Claude Code, Cursor, Windsurf, and OpenCode.

Sets up `AGENTS.md` and skill files in your project so AI assistants follow consistent rules and have access to slash commands like `/commit`, `/analyze`, `/refactor`, etc.

## Installation

```bash
npx @hd-agent-kit/cli init
```

This will:
1. Copy `AGENTS.md` to your project root
2. Copy skill files to `.claude/skills/` (Claude Code) and `.opencode/skills/` (OpenCode)
3. Configure global gitignore so these files don't get pushed to your repo

## Commands

### `init`
Copy agent files to your project and setup global gitignore.

```bash
npx @hd-agent-kit/cli init          # prompts before overwriting
npx @hd-agent-kit/cli init --force  # overwrites without asking
```

### `update`
Update all agent files to the latest version (overwrites existing files).

```bash
npx @hd-agent-kit/cli update
```

### `gitignore`
Only setup the global gitignore (without copying files).

```bash
npx @hd-agent-kit/cli gitignore
```

### Options

```bash
npx @hd-agent-kit/cli --version   # show version number
npx @hd-agent-kit/cli --help      # show help
```

## What Gets Installed

```
your-project/
├── AGENTS.md                                    ← Global AI rules (all tools read this)
├── .claude/skills/                              ← Claude Code skills
│   ├── analyze/SKILL.md
│   ├── api-design/SKILL.md
│   ├── commit/SKILL.md
│   ├── document/SKILL.md
│   ├── performance-check/SKILL.md
│   ├── refactor/SKILL.md
│   ├── security-scan/SKILL.md
│   └── write-tests/SKILL.md
└── .opencode/skills/                            ← OpenCode skills
    ├── analyze/SKILL.md
    ├── api-design/SKILL.md
    ├── commit/SKILL.md
    ├── document/SKILL.md
    ├── performance-check/SKILL.md
    ├── refactor/SKILL.md
    ├── security-scan/SKILL.md
    └── write-tests/SKILL.md
```

## Global Gitignore

The `init` and `gitignore` commands add these entries to your global gitignore:

```
AGENTS.md
.claude/
.opencode/
project-rules.md
```

This prevents agent config files from being committed to any project.

## Available Slash Commands

| Command | Description |
|---------|-------------|
| `/analyze` | Analyze project and generate `project-rules.md` (also handles new project setup) |
| `/api-design [resource]` | Design REST/GraphQL endpoints, Zod schemas, and OpenAPI docs |
| `/commit` | Analyze changes and propose a commit message |
| `/refactor [file]` | Create a step-by-step refactor plan |
| `/write-tests [file]` | Generate test files (components, API endpoints, CLI tools) |
| `/document [file]` | Generate JSDoc/TSDoc or README |
| `/performance-check` | Bundle, render, backend, and Core Web Vitals analysis |
| `/security-scan` | OWASP Top 10 risk analysis, dependency audit, env check |

## OpenCode Team Agents

This package includes a ready-made **senior-level multi-agent team** for OpenCode (`.opencode/agents/`). The team covers the full development lifecycle:

| Agent | Role | Model |
|-------|------|-------|
| `team-lead` | Orchestrates the team, makes architectural decisions | claude-opus-4-6 |
| `planner` | Translates requirements into sprint plans, API contracts, ADRs | claude-sonnet-4-6 |
| `web-developer` | Full-stack web (Next.js, Vite/React, Remix, Astro, Vue/Nuxt) | codex-5.3 |
| `mobile-developer` | Android (Kotlin/Compose) + iOS (Swift/SwiftUI) | codex-5.3 |
| `backend-developer` | APIs, database schemas, auth, service layer | codex-5.3 |
| `code-reviewer` | Security (OWASP), performance, a11y, type safety, observability | claude-sonnet-4-6 |
| `qa-engineer` | Unit, integration, and E2E test suites | codex-5.3 |
| `devops-engineer` | CI/CD pipelines, Docker, cloud deployments | codex-5.3 |
| `ui-designer` | Component specs, design tokens, accessibility | claude-sonnet-4-6 |
| `documentation-writer` | README, API docs, changelogs, ADRs | claude-sonnet-4-6 |
| `bug-triager` | Root cause analysis, prioritization, reproduction steps | claude-sonnet-4-6 |

Every agent automatically reads `AGENTS.md` and `project-rules.md` before starting any task, respecting the project's specific conventions. Run `/analyze` once to generate `project-rules.md` for your project.

### How Agents Use Your Project Rules

```
project-rules.md (generated by /analyze)
       ↓ project-specific stack, naming conventions, file map
AGENTS.md (installed by hd-agent-kit)
       ↓ global standards, TypeScript rules, component architecture
Agent behavior
```

Priority: `project-rules.md` > `AGENTS.md` > general best practices

## License

MIT