Skip to content

Aura Frog — AI-powered structured development plugin for Claude Code Turn Claude Code into a full-fledged dev platform: Aura Frog brings 24 specialized agents, a 9-phase TDD workflow, built-in quality gates and 70+ commands so your team doesn’t need to manually draft prompts — just call the right command and follow guided instructions.

Notifications You must be signed in to change notification settings

nguyenthienthanh/aura-frog

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

99 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Aura Frog

🐸 Aura Frog

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.

Version License Claude Code PRs Welcome

Quick StartFeaturesDocumentationContributing


📊 At a Glance

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

⚡ Quick Start

Prerequisites

  • Claude Code — Install Anthropic's CLI first
  • Git — Version control
  • Node.js 18+ or your project's runtime

Installation

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

Updating

# Update to latest version
/plugin marketplace update aurafrog

First Workflow

# Initialize your project (recommended)
project:init

# Start your first workflow
workflow:start "Implement user authentication"

Follow the Flow

At each phase, review and respond:

  • approve or yes — Continue to next phase
  • reject: <reason> — Restart current phase
  • modify: <changes> — Adjust deliverables

📚 See: aura-frog/GET_STARTED.md for complete guide


🎯 Overview

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.

Why Aura Frog?

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.


🎨 Key Features

🤖 24 Specialized Agents

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

⚡ 26+ Skills (14 Auto-Invoking + 12 Reference)

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


🔄 9-Phase Workflow

┌─────────────────────────────────────────────────────────────┐
│  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 Enforcement

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%

📏 37 Quality Rules

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 Modes

Full 9-Phase Workflow

workflow:start "Your complex task"

Best for: New features, complex changes, production code Time: 2-4 hours | Quality: Maximum ✅

Lightweight Commands

bugfix:quick "Fix login button"    # 30 min
refactor "src/utils/api.ts"        # 1 hour
planning "new feature"             # 30 min
document "API endpoints"           # 30 min

Best for: Small bugs, documentation, simple refactors Time: 30 min - 1 hour | Quality: Good ✅


📋 Commands Reference

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


🔗 Integrations

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


📚 Documentation

Getting Started

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

Core Documentation

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

Reference

Document Description
aura-frog/commands/README.md All 70 commands
aura-frog/agents/ All agent definitions
aura-frog/rules/ Core quality rules

🏗️ Architecture

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

Rules Priority

Project Context > Aura Frog Core Rules > Generic Defaults

Your project conventions always win over Aura Frog defaults.


🤝 Contributing

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


📄 License

MIT License — See LICENSE for details


🙏 Acknowledgments

  • Claude Code — AI-powered development platform
  • duongdev/ccpm — Original inspiration
  • Contributors — Development and testing

Code with main character energy! 🐸✨

Get StartedDocumentationReport Issue


Built with ❤️ by @nguyenthienthanh

About

Aura Frog — AI-powered structured development plugin for Claude Code Turn Claude Code into a full-fledged dev platform: Aura Frog brings 24 specialized agents, a 9-phase TDD workflow, built-in quality gates and 70+ commands so your team doesn’t need to manually draft prompts — just call the right command and follow guided instructions.

Topics

Resources

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages