claudekit/README.md

Claude Kit

A comprehensive toolkit for Claude Code to accelerate development workflows for teams working with Python and JavaScript/TypeScript.

Features

• 20 Specialized Agents - From planning to deployment
• 22+ Slash Commands - Workflow automation
• 28+ Skills - Framework, language, and methodology expertise
• 13 Methodology Skills - Superpowers development workflow
• CI/CD, Security, and API Extensions - Extended capabilities

Quick Start

1. Copy the .claude folder to your project root
2. Customize .claude/CLAUDE.md for your project
3. Start using commands like /feature, /review, /test

Directory Structure

.claude/
├── CLAUDE.md              # Project context (customize this!)
├── settings.json          # Hooks and permissions
├── agents/                # 20 specialized agents
├── commands/              # 20+ workflow commands
└── skills/                # Framework and language skills

Agents

Core Development

Agent	Description
planner	Task decomposition and planning
researcher	Technology research
debugger	Error analysis and fixing
tester	Test generation
code-reviewer	Code review with security focus
scout	Codebase exploration

Operations

Agent	Description
git-manager	Git operations and PRs
docs-manager	Documentation generation
project-manager	Progress tracking
database-admin	Schema and migrations
ui-ux-designer	UI component creation

Extended

Agent	Description
cicd-manager	CI/CD pipeline management
security-auditor	Security reviews
api-designer	API design and OpenAPI
vulnerability-scanner	Security scanning
pipeline-architect	Pipeline optimization

Commands

Development Workflow

/feature [description]   # Full feature development
/fix [error]            # Debug and fix bugs
/review [file]          # Code review
/test [scope]           # Generate tests
/tdd [feature]          # Test-driven development

Git & Deployment

/commit [message]       # Smart commit
/ship [message]         # Commit + PR
/pr [title]             # Create pull request
/deploy [env]           # Deploy to environment

Documentation & Planning

/plan [task]            # Create implementation plan
/plan --detailed [task] # Detailed plan (2-5 min tasks)
/brainstorm [topic]     # Interactive design session
/execute-plan [file]    # Subagent-driven execution
/doc [target]           # Generate documentation
/research [topic]       # Research technology

Security & Quality

/security-scan          # Scan for vulnerabilities
/api-gen [resource]     # Generate API code
/refactor [file]        # Improve code structure
/optimize [file]        # Performance optimization

Skills

Languages

• Python, TypeScript, JavaScript

Frameworks

• FastAPI, Django, Next.js, React

Databases

• PostgreSQL, MongoDB

DevOps

• Docker, GitHub Actions

Frontend

• Tailwind CSS, shadcn/ui

Security

• OWASP best practices

Testing

• pytest, vitest

Methodology (Superpowers)

Category	Skills
Planning	brainstorming, writing-plans, executing-plans
Testing	test-driven-development, verification-before-completion, testing-anti-patterns
Debugging	systematic-debugging, root-cause-tracing, defense-in-depth
Collaboration	dispatching-parallel-agents, requesting-code-review, receiving-code-review, finishing-development-branch

Key methodology principles:

• TDD Strict: No production code without failing test first
• Verification: Evidence-based completion claims
• Quality Gates: Code review between every task
• Bite-sized Tasks: 2-5 minute increments with exact code

Customization

CLAUDE.md

The .claude/CLAUDE.md file is your project context. Customize it with:

# Project: Your Project Name

## Tech Stack
- **Backend**: FastAPI
- **Frontend**: Next.js
- **Database**: PostgreSQL

## Conventions
- Use type hints
- 80% test coverage
- Conventional commits

## Agent Overrides
### Tester
- Framework: pytest
- Coverage: 90%

Adding Custom Commands

Create a new file in .claude/commands/:

# /my-command

## Purpose
Description of your command.

---

Your prompt content here.

Use $ARGUMENTS for command arguments.

Adding Custom Skills

Create a new skill in .claude/skills/category/skillname/SKILL.md:

# Skill Name

## Description
Brief description for matching.

---

## Patterns
Your patterns and examples here.

Workflow Chains

Feature Development

/feature → planner → implement → code-reviewer → tester → git-manager

Bug Fix

/fix → debugger → scout → implement → tester → code-reviewer

Ship Code

/ship → code-reviewer → tester → security-scan → git-manager

Superpowers Workflow (Detailed)

/brainstorm → /plan --detailed → /execute-plan → /ship

Uses one-question-at-a-time design, 2-5 min tasks with exact code, subagent execution with code review gates.

Requirements

• Claude Code 1.0+
• Git
• Node.js or Python (depending on your stack)

License

MIT

---

Built with duthaho