Aurakit

<div align="center"> <img src="assets/hero.svg" width="900" alt="AuraKit — One command. Full stack. Zero compromise."> <br/>

<br/> <h3>46 Modes &nbsp;·&nbsp; 10 Hooks &nbsp;·&nbsp; 23 Agents &nbsp;·&nbsp; 6-Layer Security &nbsp;·&nbsp; 8 Languages &nbsp;·&nbsp; ~55% Token Savings</h3> <p> <a href="#-before--after">Before & After</a>&nbsp;&nbsp;·&nbsp;&nbsp; <a href="#-quick-start">Quick Start</a>&nbsp;&nbsp;·&nbsp;&nbsp; <a href="#-46-modes">46 Modes</a>&nbsp;&nbsp;·&nbsp;&nbsp; <a href="#-quality-tiers">Tiers</a>&nbsp;&nbsp;·&nbsp;&nbsp; <a href="#%EF%B8%8F-how-it-works">Pipeline</a>&nbsp;&nbsp;·&nbsp;&nbsp; <a href="#-6-layer-security">Security</a>&nbsp;&nbsp;·&nbsp;&nbsp; <a href="#-new-in-v65">New in v6.5</a>&nbsp;&nbsp;·&nbsp;&nbsp; <a href="#-why-aurakit">Why AuraKit</a>&nbsp;&nbsp;·&nbsp;&nbsp; <a href="#-faq">FAQ</a> </p> </div>

---

What is AuraKit?

One command. Full-stack app. Production-ready.

AuraKit is a Claude Code skill that replaces 20+ manual instructions with a single /aura command. It auto-detects what you need, scans your project, generates code with security checks on every file, and commits — all in one shot.

npx @smorky85/aurakit        # Install once (~30 seconds, auto-installs jq)
/aura build: login with JWT  # That's it. AuraKit handles the rest.

[!TIP] 30-second install → npx @smorky85/aurakit or bash install.sh (v2.0), then type /aura in any project. jq, Python, and git are auto-detected and installed if missing.

---

🔄 Before & After

<table> <tr> <th width="50%">❌ Without AuraKit</th> <th width="50%">✅ With AuraKit</th> </tr> <tr> <td>

You: "Build a login API"
Claude: *generates code*
You: "Wait, add input validation"
Claude: *regenerates*
You: "You forgot error handling"
Claude: *patches*
You: "Check for SQL injection"
Claude: *patches again*
You: "Now write tests"
Claude: *generates tests*
You: "The types are wrong..."
(30 min later, still going)

</td> <td>

/aura build: login with JWT

# AuraKit automatically:
# → Scans your project stack (Scout/Haiku)
# → Plans file-by-file build order
# → Generates with SEC-01~15 rules
# → Validates types + security + tests
# → Commits: feat(auth): add login
# Done. One command. ~3 minutes.

</td> </tr> </table>

---

⚡ Quick Start

1 — Install (choose one)

# macOS (Homebrew)
brew install smorky85/tap/aurakit

# All platforms (npm)
npx @smorky85/aurakit

# One-liner (macOS / Linux)
curl -fsSL https://raw.githubusercontent.com/smorky850612/Aurakit/main/install.sh | bash

# Windows
npx @smorky85/aurakit

# From source
bash install.sh

[!NOTE] All install methods auto-activate L3~L5 security hooks. install.sh v2.0 auto-detects and installs: jq (winget/scoop/choco/brew/apt/dnf/yum/apk/pacman), checks Node.js, Python, and git. Configures settings.json via Python-first (jq fallback). Installs the AuraKit Nexus status bar.

2 — Use

# Recommended for daily use (hooks enforce security without per-action dialogs)
claude --dangerously-skip-permissions

/aura build: login with JWT        # BUILD mode (English)
/aura 로그인 기능 만들어줘         # BUILD mode (Korean · auto-detect)
/aura fix: TypeError in auth.ts    # FIX mode
/aura 코드 정리해줘                # CLEAN mode
/aura Vercel 배포 설정해줘         # DEPLOY mode
/aura 코드 리뷰해줘               # REVIEW mode
/aura! 버튼 색상 변경              # QUICK mode · ~60% fewer tokens

[!WARNING] What --dangerously-skip-permissions means: Claude won't ask for confirmation on each tool use. This is intentional — AuraKit's hooks (bash-guard.js, security-scan.sh) replace per-action dialogs with automated enforcement. Without install.sh, security relies only on L1/L2 (agent role isolation + tool blocklist).

Safer first-time alternative: Run claude without the flag. Claude will ask for permission on each Write/Edit/Bash call.

[!IMPORTANT] Security rules in ~/.claude/rules/aurakit-security.md are always active — applied to every Claude Code session automatically, even without running /aura.

3 — Update (existing users)

# Recommended — always fetches the latest version from npm
npx @smorky85/aurakit@latest

# From source (if you cloned the repo)
git pull origin main && bash install.sh

# One-liner (macOS / Linux)
curl -fsSL https://raw.githubusercontent.com/smorky850612/Aurakit/main/install.sh | bash

[!TIP] Running the update command re-runs install.sh automatically — hooks, skills, and security rules are all refreshed in place. Your .aura/ project data (memory, instincts, snapshots) is never overwritten.

---

🧬 DNA — 8 Core Principles

AuraKit enforces these 8 principles in every mode, every turn, every output. Any response that violates them is not AuraKit.

<div align="center">

| # | Principle | Guarantee | Mechanism | |:-:|:----------|:----------|:----------| | 1 | ⚡ FAST | Faster than any skill | Session cache · ConfigHash · QUICK mode · Progressive Load | | 2 | ✨ FLASHY | Most informative CLI output | StatusLine · Next Actions · Token Report · Pipeline display | | 3 | 🔐 SECURE | Genuinely top-tier security | 6-layer gates · 10 hooks · SEC-01~15 · bash-guard · security-scan | | 4 | 💰 THRIFTY | Max token savings even on Opus | Tiered Model · Fail-Only output · Progressive Load · Session cache | | 5 | ♾️ IMMORTAL | Survives context loss | 65% compact guard · Snapshots · PostCompact restore · Session resume | | 6 | 🧠 EVOLVING | Gets smarter with every use | Instinct learning · instinct:evolve · Pattern sharing | | 7 | 🌐 UNIVERSAL | Any platform, any language | 8 languages · 46 modes · 23 agents · 5 platforms · Non-dev QUICK mode | | 8 | 🏆 TOP-TIER | Best skill, no comparison | Sum of the above 7 |

</div>

---

🏆 Why AuraKit?

"I can just prompt Claude myself" — Yes, but you'll repeat the same 20 instructions every session.

| | Manual Prompting | CLAUDE.md File | AuraKit v6.5.0 | |:---|:---:|:---:|:---:| | Security enforcement | Hope for the best | Rules, no enforcement | 10 hooks enforce at write-time | | Context survival | Lost on compact | Partial | Snapshot + PostCompact auto-restore | | Token efficiency | Wasteful | Manual | ~55% ECO · ~75% MAX (estimated) | | Code review | Manual | Manual | 4 agents in parallel | | Multi-language | English only | English only | 8 languages · 56+ commands | | Learns over time | Starts fresh | Starts fresh | Instinct engine auto-saves patterns | | jq / tools | Manual setup | Manual setup | Auto-installed on first run | | Install time | — | 30 min writing rules | ~30 seconds |

---

🎯 46 Modes

AuraKit detects your intent from natural language. Use a namespace prefix (build:, fix:) when the mode is ambiguous.

5 Core Modes — covers 90% of daily use

| Mode | Invoke | What It Does | |:-----|:-------|:-------------| | BUILD | /aura build: ... or just describe it | Discovery → micro-plan → generate → triple verify → commit | | FIX | /aura fix: ... or paste the error | Root-cause analysis → minimal change → verify | | REVIEW | /aura review: | 4 parallel agents → VULN-NNN report, A–F grade | | CLEAN | /aura clean: | Dead code removal, 250-line splits, deduplication | | DEPLOY | /aura deploy: | Framework detect → env setup → deploy config → security recheck |

<details> <summary><strong>📋 40 Extended Modes</strong> — Quality · Planning · Platform · Utility · Autopus-ADK · Auto</summary> <br/>

Quality & Testing

| Mode | Trigger | What It Does | |:-----|:--------|:-------------| | GAP | gap:, match rate | Design ↔ implementation gap analysis (Match Rate %) | | ITERATE | iterate:, auto-fix | Auto-improve until Match Rate ≥ 90% (max 5 cycles) | | TDD | tdd:, test-first | 🔴 RED → 🟢 GREEN → 🔵 REFACTOR · coverage ≥ 70–90% | | QA | qa:, docker logs | Zero-Script QA via real Docker log analysis | | QA:E2E | qa:e2e:setup | Playwright E2E — auth / CRUD / responsive / CI pipeline | | DEBUG | debug:, 5-why | 4-phase systematic debugging with root-cause tracing |

Planning & Design

| Mode | Trigger | What It Does | |:-----|:--------|:-------------| | PM | pm:, PRD, discovery | OST + JTBD + Lean Canvas + PRD · 5 PM agents in parallel | | PLAN | plan:, 계획 | Structured plan → .aura/docs/plan-*.md | | DESIGN | design:, DB 설계 | DB + API + UI workers parallel → cross-consistency check | | REPORT | report:, 완료 보고서 | 4-perspective value report (user/biz/tech/ops) | | PIPELINE | pipeline:, 개발 순서 | 9-phase guide: Starter / Dynamic / Enterprise | | BRAINSTORM | brainstorm:, HMW | HMW + priority matrix → actionable ideas |

Advanced Operations

| Mode | Trigger | What It Does | |:-----|:--------|:-------------| | ORCHESTRATE | orchestrate:, leader | Leader / Swarm / Council / Watchdog multi-agent patterns | | BATCH | batch:[A,B,C] | Up to 5 features in parallel Git Worktrees | | LOOP | batch:loop: until:pass | Autonomous iteration loop until condition met | | FINISH | finish:, squash | Branch squash merge + Worktree cleanup | | ARCHIVE | archive:, archive:list | Archive features without deleting |

Platform Specialists

| Mode | Trigger | What It Does | |:-----|:--------|:-------------| | MOBILE | mobile:, react native | React Native / Expo specialized pipeline | | DESKTOP | desktop:, electron | Electron / Tauri specialized pipeline | | BAAS | baas:, supabase | Supabase / Firebase / bkend integration guide | | PAYMENT | payment:, stripe, polar, toss | Stripe · LemonSqueezy · Polar · TossPayments · StepPay — full subscription billing pipeline (default PRO tier) |

Intelligence & Configuration

| Mode | Trigger | What It Does | |:-----|:--------|:-------------| | INSTINCT | instinct:show | View / manage / evolve learned project patterns | | LANG | lang:python, lang:go | Force language-specific code reviewer (10 languages) | | MCP | mcp:setup, mcp:list | Install & configure 14 MCP server types | | CONTENT | content:, 블로그 | Blog, market research, IR deck, tech docs, email, social | | STATUS | status, 현재 상태 | Current work state from .aura/snapshots/ | | STATUS:HEALTH | status:health | Health Dashboard — Match Rate · security score · coverage · Tech Debt | | CONFIG | config:set | Manage .aura/config.json settings |

Utility

| Mode | Trigger | What It Does | |:-----|:--------|:-------------| | STYLE | style:, learning | Switch output persona: learning / expert / concise | | SNIPPETS | snippets:, 스니펫 | Save and reuse prompt templates | | QUICK (!) | /aura! request | Protocol-minimal, single file, ~60% token savings | | BUILD_RESOLVER | (auto on V1 fail) | Language-spec