A Plugin for Claude Code
Code with main character energy ✨
AI-powered development plugin for Claude Code with 24 specialized agents, 9-phase TDD workflow.
| Agents | Skills | Rules | Phases | Commands |
|---|---|---|---|---|
| 24 | 26+ | 36 | 9 | 70+ |
What's Inside:
- 🤖 24 Specialized Agents — Mobile, Web, Backend, QA, Security, DevOps, and more
- ⚡ 26+ Skills — 14 auto-invoking + 12 reference skills for specialized tasks
- 🎨 10 Design Systems — MUI, Ant Design, Tailwind, shadcn/ui, Chakra, NativeWind, and more
- 📏 37 Quality Rules — System, code quality, architecture, workflow, documentation, and accessibility
- 🔄 9-Phase Workflow — From requirements to deployment with quality gates
- 🎮 70+ Commands — Full workflow control at your fingertips
- 🔗 4 Integrations — JIRA, Figma, Slack, Confluence (via Bash scripts)
- 🔀 Multi-Model Support — Use Gemini, OpenAI, DeepSeek per phase
- 📊 10 Mermaid Diagrams — Visual workflow documentation
- Claude Code — Install Anthropic's CLI first
- Git — Version control
- Node.js 18+ or your project's runtime
In Claude Code terminal:
# Step 1: Add Aura Frog Marketplace (one-time)
/plugin marketplace add nguyenthienthanh/aura-frog
# Step 2: Install Aura Frog Plugin
/plugin install aura-frog@aurafrog
# Step 3: Create local settings (required)
cd ~/.claude/plugins/marketplaces/aurafrog/aura-frog/
cp settings.example.json settings.local.json# Update to latest version
/plugin marketplace update aurafrog# Initialize your project (recommended)
project:init
# Start your first workflow
workflow:start "Implement user authentication"At each phase, review and respond:
approveoryes— Continue to next phasereject: <reason>— Restart current phasemodify: <changes>— Adjust deliverables
📚 See: aura-frog/GET_STARTED.md for complete guide
Aura Frog is a plugin for Claude Code (Anthropic's official CLI for Claude) that transforms it into a structured development platform with specialized agents, enforced TDD, and quality gates at every step.
What is Claude Code? Claude Code is Anthropic's agentic coding tool that operates in your terminal, understands your codebase, and helps you code faster through natural conversation. Aura Frog extends Claude Code with structured workflows and specialized agents.
| Traditional Development | With Aura Frog |
|---|---|
| Manual task management | AI-powered 9-phase workflow |
| Generic AI responses | 24 specialized agents auto-selected |
| Testing as afterthought | TDD enforced (RED → GREEN → REFACTOR) |
| Ad-hoc code review | Multi-agent cross-review built-in |
| Context switching | CLI-first with 70 commands |
| Manual documentation | Auto-generated docs |
Result: 60-70% reduction in PM overhead while improving code quality.
Agents auto-activate based on your prompt context:
Development Agents (11)
| Agent | Specialization |
|---|---|
mobile-react-native |
React Native + Expo, adaptive styling |
mobile-flutter |
Flutter + Dart, cross-platform |
web-angular |
Angular 17+, signals, standalone components |
web-vuejs |
Vue 3, Composition API, Pinia |
web-reactjs |
React 18, hooks, Context API |
web-nextjs |
Next.js, SSR, SSG, App Router |
backend-nodejs |
Node.js, Express, NestJS, Fastify |
backend-python |
Django, FastAPI, Flask |
backend-go |
Go, Gin, Fiber, gRPC |
backend-laravel |
Laravel PHP, Eloquent |
database-specialist |
Schema design, query optimization |
Quality, Security & Design (3)
| Agent | Specialization |
|---|---|
security-expert |
OWASP audits, vulnerability scanning |
qa-automation |
Jest, Cypress, Detox, testing strategies |
ui-designer |
UI/UX, Figma integration, accessibility |
DevOps & Operations (5)
| Agent | Specialization |
|---|---|
devops-cicd |
Docker, K8s, CI/CD, monitoring |
jira-operations |
JIRA integration, ticket management |
confluence-operations |
Documentation publishing |
slack-operations |
Team notifications |
voice-operations |
ElevenLabs AI narration |
Infrastructure (5)
| Agent | Specialization |
|---|---|
smart-agent-detector |
Intelligent agent selection |
pm-operations-orchestrator |
Workflow coordination |
project-detector |
Auto-detect project type |
project-config-loader |
Load configurations |
project-context-manager |
Context persistence |
Skills activate automatically based on your message context — no commands needed:
User: "Implement user profile from PROJ-1234"
↓
Auto-invokes:
1. agent-detector → Selects mobile-react-native agent
2. jira-integration → Fetches PROJ-1234 requirements
3. project-context-loader → Loads your conventions
4. model-router → Selects model for current phase
5. workflow-orchestrator → Executes 9-phase workflow
| Skill | Triggers | Purpose |
|---|---|---|
agent-detector |
Every message | Select appropriate agent |
workflow-orchestrator |
"implement", "build", "create" | Execute 9-phase workflow |
project-context-loader |
Before code generation | Load project conventions |
model-router |
Phase transitions | Select AI model per phase |
session-continuation |
Token limit (150K+) | Workflow state & handoff |
bugfix-quick |
"fix", "error", "broken" | Fast TDD bug fixes |
test-writer |
"add tests", "coverage" | Generate comprehensive tests |
code-reviewer |
After implementation | Multi-agent quality review |
jira-integration |
PROJ-1234 patterns | Auto-fetch ticket details |
figma-integration |
Figma URLs | Extract design components |
confluence-integration |
Confluence URLs | Fetch/create/update pages |
lazy-agent-loader |
Agent loading | 94% token savings on agent defs |
response-analyzer |
Large outputs | Save verbose output to temp |
state-persistence |
Session handoff | File-based state management |
Reference Skills (12): refactor-expert, api-designer, performance-optimizer, migration-helper, phase-skipping, estimation, documentation, nativewind-component-generator, qa-expert, dev-expert, design-expert, scalable-thinking
📚 See: aura-frog/skills/README.md for complete documentation
┌─────────────────────────────────────────────────────────────┐
│ Phase 1: Understand 🎯 → "What are we building?" │
│ Phase 2: Design 🏗️ → "How will we build it?" │
│ Phase 3: UI Breakdown 🎨 → "What does it look like?" │
│ Phase 4: Plan Tests 🧪 → "How will we test it?" │
├─────────────────────────────────────────────────────────────┤
│ Phase 5a: Write Tests 🔴 → TDD RED - Tests must FAIL │
│ Phase 5b: Build 🟢 → TDD GREEN - Tests must PASS │
│ Phase 5c: Polish ♻️ → TDD REFACTOR - Stay green │
├─────────────────────────────────────────────────────────────┤
│ Phase 6: Review 👀 → Multi-agent code review │
│ Phase 7: Verify ✅ → QA validation │
│ Phase 8: Document 📚 → Auto-generate docs │
│ Phase 9: Share 🔔 → Team notification │
└─────────────────────────────────────────────────────────────┘
Quality Gates: Human approval required after every phase — no auto-progression!
TDD is non-negotiable in Aura Frog:
┌─────────┐ ┌─────────┐ ┌───────────┐
│ RED │ → │ GREEN │ → │ REFACTOR │
│ Write │ │ Make │ │ Improve │
│ Tests │ │ Pass │ │ Code │
└─────────┘ └─────────┘ └───────────┘
FAIL PASS PASS
- ❌ Cannot implement without tests
- ❌ Cannot proceed if tests don't fail (RED)
- ❌ Cannot proceed if tests don't pass (GREEN)
- ❌ Cannot proceed if coverage below 80%
Aura Frog enforces consistent quality through comprehensive rules:
System & Session Rules (6)
| Rule | Purpose |
|---|---|
agent-identification-banner |
Show agent banner every response |
env-loading |
Load .envrc at session start |
execution-rules |
ALWAYS/NEVER execution rules |
priority-hierarchy |
Config priority order |
dual-file-architecture |
Plugin + project structure |
token-time-awareness |
Monitor token usage |
Code Quality Rules (10)
| Rule | Purpose |
|---|---|
yagni-principle |
Only implement what's needed now |
dry-with-caution |
Rule of Three before abstracting |
kiss-avoid-over-engineering |
Keep it simple |
error-handling-standard |
Typed errors, proper logging |
logging-standards |
Structured logging, sanitization |
code-quality |
TypeScript strict, no any |
naming-conventions |
Consistent naming |
smart-commenting |
Why, not what |
modern-javascript |
ES6+ syntax required |
prefer-established-libraries |
Use lodash/es-toolkit over custom utils |
Architecture Rules (5)
| Rule | Purpose |
|---|---|
api-design-rules |
RESTful conventions |
state-management |
React/Vue state patterns |
dependency-management |
Version pinning, audits |
performance-rules |
Optimization guidelines |
theme-consistency |
Design system adherence |
Workflow Rules (10)
| Rule | Purpose |
|---|---|
tdd-workflow |
RED → GREEN → REFACTOR |
cross-review-workflow |
Multi-agent review |
approval-gates |
Human approval required |
git-workflow |
Commit conventions |
safety-rules |
Security guidelines |
next-step-guidance |
Always show next steps |
workflow-navigation |
Progress tracking |
feedback-brainstorming |
Brainstorm before feedback |
impact-analysis |
Analyze usages before modifying |
workflow-deliverables |
Verify all phase docs created |
Security Rules (1)
| Rule | Purpose |
|---|---|
sast-security-scanning |
OWASP Top 10, SAST scanning, secrets detection |
Documentation Rules (1)
| Rule | Purpose |
|---|---|
diagram-requirements |
Mermaid diagrams for complex features |
Accessibility & UI Rules (3)
| Rule | Purpose |
|---|---|
accessibility-rules |
WCAG compliance, ARIA |
correct-file-extensions |
Proper file naming |
direct-hook-access |
Lifecycle hooks |
📚 See: aura-frog/rules/ for all rule definitions
workflow:start "Your complex task"Best for: New features, complex changes, production code Time: 2-4 hours | Quality: Maximum ✅
bugfix:quick "Fix login button" # 30 min
refactor "src/utils/api.ts" # 1 hour
planning "new feature" # 30 min
document "API endpoints" # 30 minBest for: Small bugs, documentation, simple refactors Time: 30 min - 1 hour | Quality: Good ✅
Workflow Commands
| Command | Description |
|---|---|
workflow:start <task> |
Start full 9-phase workflow |
workflow:status |
Show current progress |
workflow:approve |
Approve current phase |
workflow:reject <reason> |
Reject and restart phase |
workflow:handoff |
Save for session continuation |
workflow:resume [id] |
Resume saved workflow |
Quick Commands
| Command | Description |
|---|---|
bugfix:quick <desc> |
Quick bug fix with TDD |
bugfix:hotfix <desc> |
Emergency hotfix |
refactor <file> |
Code refactoring |
planning <task> |
Create execution plan |
document <feature> |
Generate documentation |
Testing Commands
| Command | Description |
|---|---|
test:unit <file> |
Generate unit tests |
test:e2e <flow> |
Generate E2E tests |
test:coverage |
Check coverage |
Project Commands
| Command | Description |
|---|---|
project:init |
Initialize Aura Frog for project |
project:detect |
Auto-detect project type |
project:regen |
Re-generate context |
project:reload-env |
Load/reload .envrc variables |
agent:list |
Show all agents |
agent:info <name> |
Show agent details |
📚 See: aura-frog/commands/README.md for all 70+ commands
Aura Frog includes native Bash script integrations:
| Integration | Purpose | Auto-Trigger |
|---|---|---|
| JIRA | Fetch tickets, update status | PROJ-1234 in message |
| Figma | Extract designs, components | Figma URL in message |
| Slack | Send notifications | Phase 9 completion |
| Confluence | Publish documentation | Phase 8 completion |
# Auto-fetch JIRA ticket requirements
workflow:start "Implement PROJ-1234"
# Auto-fetch Figma design
workflow:start "Build https://figma.com/file/ABC123/Design"📚 Setup: aura-frog/docs/INTEGRATION_SETUP_GUIDE.md
| Document | Description |
|---|---|
| aura-frog/GET_STARTED.md | Quick start guide (5 minutes) |
| aura-frog/docs/PLUGIN_INSTALLATION.md | Official installation guide |
| aura-frog/TESTING_GUIDE.md | Testing workflows |
| Document | Description |
|---|---|
| aura-frog/CLAUDE.md | AI instructions (for Claude) |
| aura-frog/docs/phases/ | 9 detailed phase guides |
| aura-frog/docs/RULES_COMBINATION.md | How rules are combined |
| aura-frog/skills/README.md | Skills system guide |
| aura-frog/docs/WORKFLOW_DIAGRAMS.md | 10 visual workflow diagrams |
| aura-frog/docs/MULTI_SESSION_ARCHITECTURE.md | Token optimization & session handoff |
| Document | Description |
|---|---|
| aura-frog/commands/README.md | All 70 commands |
| aura-frog/agents/ | All agent definitions |
| aura-frog/rules/ | Core quality rules |
aura-frog/ # Repository root
├── aura-frog/ # Main plugin directory
│ ├── agents/ # 24 specialized agents
│ ├── skills/ # 26+ skills (14 auto + 12 reference)
│ ├── commands/ # 70+ workflow commands
│ ├── rules/ # 38 quality rules
│ ├── docs/ # Comprehensive documentation
│ │ ├── phases/ # 9 phase guides
│ │ └── WORKFLOW_DIAGRAMS.md # 10 Mermaid diagrams
│ ├── hooks/ # Lifecycle hooks
│ ├── scripts/ # Integration scripts
│ └── templates/ # Document templates
├── assets/ # Logo and images
├── scripts/ # Development scripts
└── README.md # This file
Project Context > Aura Frog Core Rules > Generic Defaults
Your project conventions always win over Aura Frog defaults.
Contributions welcome! Here's how you can help:
| Priority | Area | Description |
|---|---|---|
| 🔴 High | Agents | Add new specialized agents |
| 🔴 High | Skills | Create new auto-invoking skills |
| 🟡 Medium | Commands | Add workflow commands |
| 🟡 Medium | Docs | Improve documentation |
| 🟢 Low | Templates | Add document templates |
Submit issues or pull requests to GitHub
MIT License — See LICENSE for details
- Claude Code — AI-powered development platform
- duongdev/ccpm — Original inspiration
- Contributors — Development and testing
Code with main character energy! 🐸✨
Get Started • Documentation • Report Issue
Built with ❤️ by @nguyenthienthanh