Files
claudekit/README.md
T

204 lines
4.2 KiB
Markdown

# 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
- **20+ Slash Commands** - Workflow automation
- **15+ Skills** - Framework and language expertise
- **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
```bash
/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
```bash
/commit [message] # Smart commit
/ship [message] # Commit + PR
/pr [title] # Create pull request
/deploy [env] # Deploy to environment
```
### Documentation & Planning
```bash
/plan [task] # Create implementation plan
/doc [target] # Generate documentation
/research [topic] # Research technology
```
### Security & Quality
```bash
/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
## Customization
### CLAUDE.md
The `.claude/CLAUDE.md` file is your project context. Customize it with:
```markdown
# 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/`:
```markdown
# /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`:
```markdown
# 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
```
## Requirements
- Claude Code 1.0+
- Git
- Node.js or Python (depending on your stack)
## License
MIT
---
Built with duthaho