# Humand Frontend Sandbox — Plugin Maintenance Guide

Plugin for Claude Code that supports the full lifecycle of frontend sandbox projects built with `humand-create-app`. Target users: non-technical (CX, Design) creating React mockups without coding.

## Directory Structure

| Path | Purpose |
|------|---------|
| `skills/` | One subdirectory per skill, each with `SKILL.md` + optional assets |
| `rules/file-types/` | Rules injected per file type: `sandbox.md`, `sandbox-components.md`, `sandbox-styling.md`, `sandbox-preflight.md` |
| `rules/workflows/` | Workflow rules — `alwaysApply: true` for global constraints, `false` for opt-in |
| `commands/` | Slash commands: `start-project`, `stop-project`, `tsc-check`, `lint-fix` |
| `agents/` | Named sub-agents invoked by skills (e.g. `secret-scanner`) |
| `references/` | Reference docs for agents: `CONVENTIONS.md`, `PATTERNS.md` |
| `.claude-plugin/` | Claude Code plugin manifest |
| `.cursor-plugin/` | Cursor IDE plugin manifest |

## Adding a Skill

1. Create `skills/<skill-name>/SKILL.md` with the required frontmatter (see below).
2. **Update `skills/get-started/SKILL.md`** — add the skill under the correct category in **Available Skills**. The list is hardcoded; skills are not auto-discovered. A skill missing from that list is invisible to users asking "what can I do?".
3. Add to **Typical Workflows** in `get-started/SKILL.md` if it belongs in a standard flow.

## Skill Frontmatter

```yaml
---
name: skill-name          # kebab-case, letters/numbers/hyphens only
description: Use when...  # triggering conditions only — no workflow summary
metadata:
  category: <category>    # see table below
---
```

### Skill Categories (in display order)

| Category | Current skills |
|----------|----------------|
| `Setup & Environment` | setup-sandbox, cleanup-sandbox, setup-supabase, sync-vercel-env |
| `Project Creation` | bootstrap-react-project, humandify-project, plan-project, document-project |
| `Feature Definition` | fetch-feature-spec, refine-feature, document-feature |
| `Implementation` | build-feature, connect-service, add-super-admin-login, add-login |
| `Security & Maintenance` | audit-secrets, audit-secrets-diff |
| `Handoff` | commit-feature, handoff-feature |
| `Quality` | verify-feature |
| `Meta` | get-started |

## Adding a Rule

- `rules/file-types/` — loaded per file type. Use `alwaysApply: true` sparingly (loaded in every conversation).
- `rules/workflows/` — workflow rules. `alwaysApply: true` for hard constraints (e.g. "never build without a Notion plan"), `false` for step-specific guidance.

## Adding a Command

Create `commands/<name>.md`. Commands are auto-discovered — no manifest update needed.