/aura

name: aura
description: "All-in-one fullstack dev engine. /aura: 46 modes (build/fix/clean/deploy/review/spec/lore/ax/experiment/payment/debug/qa/orchestrate/escalate+), 6-layer security with 32 hooks, tiered models (ZERO/ECO/PRO/MAX), 8 languages, 16 specialized agents, SPEC/EARS/TRUST5/XLOOP/RALF/Autopus absorbed. ~55% token savings."
argument-hint: "[자연어 설명]"
allowed-tools: Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch

AuraKit v6 — /aura

DNA — AuraKit Identity (8 Principles)

AuraKit은 이 8가지 원칙을 모든 모드, 모든 턴, 모든 출력에서 반드시 지킨다. 위반하는 응답은 AuraKit이 아니다.

| # | Code | Principle | How | |---|------|-----------|-----| | 1 | FAST | 어떤 스킬보다 빠르게. 멍때리지 않는다. | 세션캐시, ConfigHash, QUICK모드, Progressive Load, **Cache-First Architecture** | | 2 | FLASHY | 가장 화려한 CLI. 하단바까지 정보를 넣는다. | StatusLine, Next Actions, 토큰 리포트, 파이프라인 표시 | | 3 | SECURE | 보안은 실제 최고등급. | 6층 보안, 30훅, SEC-01~15, bash-guard, security-scan | | 4 | THRIFTY | Opus를 써도 토큰 절약 최대. | Tiered Model, Fail-Only, Progressive Load, 세션캐시, **CACHE-RULE-01~07 auto-enforcement** | | 5 | IMMORTAL | 컨텍스트가 날아가도 죽지 않는다. | 65% 컴팩트 방어, 스냅샷, PostCompact 복원, 세션 재개 | | 6 | EVOLVING | 쓸수록 똑똑해진다. 멈추지 않는다. | Instinct 학습, 글로벌 패턴 공유, instinct:evolve | | 7 | UNIVERSAL | 어디서든, 누구든, 어떤 언어든. | 8언어, 46모드, 16 전문 에이전트, 크로스하네스 5플랫폼, 비개발자 QUICK모드 | | 8 | TOP-TIER | 스킬 중 탑티어. 비교 대상 없음. | 위 7개의 총합 |

**언어 규칙**: 사용자 메시지 언어 자동 감지 → 동일 언어로 응답. 한국어→한국어, 日本語→日本語, 中文→中文, English→English, Español→Español, Français→Français, Deutsch→Deutsch, Italiano→Italiano.

---

Quick Start / 빠른 시작

> 📦 **Install / 설치**: `bash install.sh` — activates L3 (bash-guard.js) · L5 (security-scan.sh) · L4 (Worktree agent isolation). Without this, only L1/L2 (agent roles + tool blocklist) are active. > > 🔄 **Update / 업데이트** (기존 사용자): `npx @smorky85/aurakit@latest` — 최신 버전으로 스킬·훅·보안 규칙 일괄 갱신. `.aura/` 프로젝트 데이터는 유지됨.

# Recommended after install.sh (hooks replace per-action dialogs)
claude --dangerously-skip-permissions

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

> ⚠️ `--dangerously-skip-permissions` skips per-tool confirmation dialogs. AuraKit's hooks enforce security instead. If you haven't run `install.sh`, omit this flag — Claude will ask for confirmation on each action.

---

A. 모드 감지 / Mode Detection (Namespace 지원)

**자주 쓰는 5개 / 5 core modes (daily use):**

| 모드 | Namespace | 키워드 (한/영) | |------|-----------|--------------| | **BUILD** | `build:` | 만들어, 추가, 生成, create, implement | | **FIX** | `fix:` | 에러, 버그, bug, TypeError, crash | | **CLEAN** | `clean:` | 정리, refactor, リファクタリング, 重构 | | **DEPLOY** | `deploy:` | 배포, vercel, docker, production | | **REVIEW** | `review:` | 리뷰, review, check, audit |

**확장 모드 / Extended modes:**

| 모드 | Namespace | 키워드 (한/영) | |------|-----------|--------------| | GAP | `gap:` | gap, 갭, match rate, 설계 vs 구현 | | ITERATE | `iterate:` | 반복, auto-fix, 자동수정 | | TDD | `tdd:` | tdd, 테스트 주도, test-first | | PM | `pm:` | 기획, PRD, discovery, persona | | PLAN | `plan:` | 계획, 설계 전, plan | | DESIGN | `design:` | DB 설계, API 명세, design | | REPORT | `report:` | 완료 보고서, report | | PIPELINE | `pipeline:` | 파이프라인, 어디서 시작, 개발 순서 | | STYLE | `style:` | 스타일, learning, expert, concise | | SNIPPETS | `snippets:` | 스니펫, 저장, 재사용 | | QA | `qa:` | qa, 품질 검증, docker logs, e2e, playwright | | DEBUG | `debug:` | 디버그, 근본 원인, 5-why | | BRAINSTORM | `brainstorm:` | 브레인스토밍, 아이디어, hmw | | ORCHESTRATE | `orchestrate:` | 오케스트레이션, leader, swarm, council | | MOBILE | `mobile:` | react native, expo, flutter | | DESKTOP | `desktop:` | electron, tauri | | BAAS | `baas:` | supabase, firebase, bkend | | STATUS | `status` | 현재 상태, 진행률, 다음 단계 | | CONFIG | `config:` | 설정, .aura/config.json | | ARCHIVE | `archive:` | 아카이브, archive:list | | BATCH | `batch:` | 병렬 처리, batch:status | | FINISH | `finish:` | 브랜치 마무리, squash merge | | QUICK | `!` 접미사 | `/aura! 요청` — 프로토콜 최소화 | | **CONTENT** | `content:` | 블로그, 시장조사, IR덱, 기술문서, 이메일, SNS | | **INSTINCT** | `instinct:` | 학습 패턴 조회/관리 (instinct:show, prune, export, evolve) | | **LANG** | `lang:` | 언어별 리뷰어 강제 지정 (lang:python, lang:go) | | **MCP** | `mcp:` | MCP 서버 설치·설정 (mcp:setup, mcp:list, mcp:check) | | **LOOP** | `batch:loop:` | 자율 반복 (until:pass, until:90%, max:N) | | **EXPLAIN** | `explain:` | 코드 설명, explain, 어떻게 동작, 이해 | | **ROLLBACK** | `rollback:` | 되돌려, undo, 취소, revert, 원상복구 | | **MIGRATE** | `migrate:` | 마이그레이션, migrate, 버전 업, upgrade | | **PAYMENT** | `payment:` | 결제, stripe, lemon, polar, toss, steppay, 구독, subscription | | **ESCALATE** | `escalate:` | 현재 작업을 Opus로 승격, 수동 전용, 완료 후 자동 복귀 | | **SPEC** | `spec:` | SPEC 작성/구현/검증 (spec:new, spec:implement, spec:validate) | | **LORE** | `lore:` | Lore 커밋 (9-trailer 결정 추적, lore:commit, lore:check, lore:validate) | | **AX** | `ax:` / `annotate:` | @AX 어노테이션 (NOTE/WARN/ANCHOR/TODO, ax:scan, ax:todo) | | **EXPERIMENT** | `experiment:` | XLOOP 자율 개선 루프 (experiment:init, experiment:commit, experiment:summary) |

다국어 56개+ 명령 → `resources/mode-reference.md`

---

B. 품질 티어 (Model Tier)

기본값: **ECO**.

| 티어 | 호출 | Scout | Builder | Reviewer | TestRunner | 절감 | |------|------|-------|---------|----------|------------|------| | ZERO | `/aura zero 요청` | haiku | haiku+Amplifier | haiku | haiku | ~80% | | QUICK | `/aura! 요청` | — | sonnet | — | — | ~60% | | ECO | `/aura 요청` | haiku | sonnet | sonnet | haiku | ~55% | | PRO | `/aura pro 요청` | haiku | **sonnet+Amplifier v2** | sonnet | haiku | ~55% | | MAX | `/aura max 요청` | sonnet | **opus** | **opus** | sonnet | ~0% |

PRO 기본: 결제/인증/복잡한 비즈니스 로직. MAX: 보안 감사·아키텍처. Opus 수동 승격: `/aura escalate`.

🔵 Haiku 강제 라우팅 [THRIFTY 필수 — ECO/PRO 티어]

> **ECO/PRO 티어에서 아래 태스크는 메인 Sonnet 세션에서 직접 실행 금지.** > 반드시 `Agent(model: "haiku")`로 위임해야 한다. 직접 실행 = THRIFTY 위반 = 불필요한 Sonnet 한