npm package: @husnudarici/claude-kit
Description: Scaffold a .claude/ folder with agents, commands, hooks, rules, skills, and settings for Claude Code projects
Author: husnudarici
Latest version: 1.2.0

# @husnudarici/claude-kit

Scaffold a complete `.claude/` folder structure for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) projects with one command.

Sets up agents, commands, hooks, rules, skills, and settings so Claude Code works exactly the way you want -- optimized for SaaS developers building Web, Android, and iOS apps.

## Quick Start

```bash
npx @husnudarici/claude-kit init
```

That's it. Your `.claude/` folder is ready.

## What it creates

```
.claude/
├── agents/                    # Custom AI agents
│   ├── code-reviewer.md       # Reviews PRs for bugs, security, performance
│   ├── debugger.md            # Systematic bug diagnosis
│   ├── test-writer.md         # Generates comprehensive test suites
│   ├── refactorer.md          # Improves code structure safely
│   ├── doc-writer.md          # Generates documentation from code
│   ├── security-auditor.md    # OWASP-based security audits
│   ├── frontend-developer.md  # Builds complete UI features autonomously
│   ├── backend-helper.md      # Backend work with simple explanations
│   ├── mobile-developer.md    # Cross-platform Android & iOS development
│   └── reverse-engineer.md    # Analyzes competitors and libraries
├── commands/                  # One-word automations
│   ├── fix-issue.md           # Diagnose and fix GitHub issues
│   ├── deploy.md              # Deploy to production with all checks
│   ├── pr-review.md           # Thorough PR review workflow
│   └── new-saas-feature.md    # Build a full SaaS feature end-to-end
├── hooks/                     # Auto-run scripts
│   ├── pre-commit.sh          # Type check + lint + test before commit
│   └── lint-on-save.sh        # Auto-lint after every file edit
├── rules/                     # Guardrails scoped to file patterns
│   ├── frontend.md            # Component structure, styling, performance, a11y
│   ├── database.md            # Query safety and migration rules
│   ├── api.md                 # API route validation and error handling
│   ├── mobile.md              # Mobile app platform rules
│   └── saas.md                # SaaS patterns (auth, billing, onboarding)
├── skills/                    # Reusable capability bundles
│   ├── frontend-design/
│   │   └── SKILL.md           # Design system enforcement
│   └── saas-patterns/
│       └── SKILL.md           # SaaS UI/UX patterns
└── settings.local.json              # Permissions, model, hooks config
CLAUDE.md                      # Project brain -- root context file
```

## Features

### Agents (10)

Custom AI teammates that handle specific tasks autonomously:

- **frontend-developer** -- Builds complete UI features; you review, it codes
- **backend-helper** -- Builds APIs and DB schemas, explains everything simply for frontend devs
- **mobile-developer** -- Cross-platform Android & iOS with React Native / Expo
- **reverse-engineer** -- Analyzes competitor apps, libraries, and npm packages
- **code-reviewer** -- Reviews code for bugs, security issues, and performance
- **debugger** -- Traces bugs systematically using evidence
- **test-writer** -- Generates unit, integration, and edge case tests
- **refactorer** -- Improves code structure without changing behavior
- **doc-writer** -- Creates clear documentation from code analysis
- **security-auditor** -- Audits code following OWASP top 10

### Commands (4)

Slash commands that trigger multi-step workflows:

- `/deploy` -- Full deployment with pre-flight checks and verification
- `/fix-issue` -- End-to-end GitHub issue resolution
- `/pr-review` -- Thorough pull request review
- `/new-saas-feature` -- Plan and build a complete SaaS feature (DB + API + Web + Mobile)

### Hooks (2)

Shell scripts that auto-run after Claude's actions:

- **pre-commit.sh** -- Blocks commits if types, lint, or tests fail
- **lint-on-save.sh** -- Auto-lints files after every Edit/Write

### Rules (5)

Guardrails scoped to specific file patterns:

- **frontend.md** -- Feature-based component structure (enforced), styling, performance, a11y
- **database.md** -- Query safety, migrations, RLS, performance
- **api.md** -- Input validation, auth, error handling, rate limiting
- **mobile.md** -- Navigation, safe areas, platform differences, offline, app store rules
- **saas.md** -- Auth flows, subscription/billing, multi-tenancy, onboarding

### Skills (2)

Reusable capability bundles with prompts and triggers:

- **frontend-design** -- Enforces design system (colors, typography, spacing)
- **saas-patterns** -- SaaS UI patterns (pricing, dashboard, settings, onboarding, auth pages)

### Settings

Pre-configured `settings.local.json` with:

- Safe permission allow/deny lists
- Lint-on-save hook for auto-formatting
- Expo and React Native commands whitelisted
- Model selection, memory, and git instruction toggles

## Options

```bash
# Scaffold .claude/ folder (files are git-tracked, shared with team)
npx @husnudarici/claude-kit init

# Scaffold + add to global .gitignore (personal use, never pushed to git)
npx @husnudarici/claude-kit ignore-init

# Overwrite existing files
npx @husnudarici/claude-kit init --force
npx @husnudarici/claude-kit ignore-init --force
```

### `init` vs `ignore-init`

| | `init` | `ignore-init` |
|---|---|---|
| Creates `.claude/` + `CLAUDE.md` | Yes | Yes |
| Files tracked by git | Yes | No |
| Team members see the config | Yes | No |
| Adds to global `.gitignore` | No | Yes |

## Customization

After scaffolding, customize everything for your project:

1. **CLAUDE.md** -- Update tech stack, folder structure, and conventions
2. **Agents** -- Modify review criteria, add project-specific checks
3. **Rules** -- Adjust file path patterns to match your project structure
4. **Commands** -- Update deploy steps for your CI/CD pipeline
5. **Settings** -- Configure permissions for your specific tools
6. **Skills** -- Update design tokens to match your brand

## License

MIT