# Humand AI Agent Plugins

Company-wide marketplace for AI agent plugins used across Humand teams.

This repository hosts multiple plugins:

- shared or cross-area plugins
- area-specific plugins (Product, future teams)
- starter templates to bootstrap new areas quickly

## Plugin Catalog

| Plugin | Scope | Status |
|------|------|--------|
| `humand-product-workflow` | Product-only workflows (planning, sprint, staging) | Active |
| `humand-react` | React SPAs: conventions, Jira workflows, commands, skills | Active |
| `humand-tech` | Engineering: vendored superpowers + Humand-specific tech skills/rules + workflow orchestration migration | Active |
| `humand-backend` | Backend: Kafka CDC consumers, Java project kickoff, Terraform | Active |
| `humand-design` | Design system foundations: colors, typography, spacing, components | Active |
| `humand-frontend-sandbox` | Non-tech users (design, CX): scaffold, plan, build and validate React mockups | Active |
| `humand-area-starter` | Example starter for future areas | Template-only (not published) |

`humand-area-starter` is kept only as a folder template at `plugins/humand-area-starter/`.
It is intentionally not listed in active `plugins[]` for either marketplace.

## Structure

```text
.cursor-plugin/marketplace.json
.claude-plugin/marketplace.json
plugins/
  humand-product-workflow/
    .cursor-plugin/plugin.json
    .claude-plugin/plugin.json
  humand-react/
    .cursor-plugin/plugin.json
    .claude-plugin/plugin.json
  humand-area-starter/
    .cursor-plugin/plugin.json
    .claude-plugin/plugin.json
docs/
  add-a-plugin.md
scripts/
  validate-template.mjs
```

## Add a New Area Plugin

1. Create `plugins/humand-<area>-workflow/`.
2. Add `.cursor-plugin/plugin.json` and `.claude-plugin/plugin.json` inside the plugin folder.
3. Register it in `.cursor-plugin/marketplace.json` and `.claude-plugin/marketplace.json`.
4. Run both validations.

Detailed guide: `docs/add-a-plugin.md`.

## Validation

Run:

```bash
node scripts/validate-template.mjs
claude plugin validate .
```

- `node scripts/validate-template.mjs` validates Cursor marketplace/manifests.
- `claude plugin validate .` validates Claude marketplace/manifests.
