@husnudarici/claude-kit

Scaffold a complete .claude/ folder structure for 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

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

# 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