# Aura

> 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.

- **Type:** Skill
- **Install:** `agentstack add skill-smorky850612-aurakit-aura`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [smorky850612](https://agentstack.voostack.com/s/smorky850612)
- **Installs:** 0
- **Category:** [Finance & Payments](https://agentstack.voostack.com/c/finance-and-payments)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [smorky850612](https://github.com/smorky850612)
- **Source:** https://github.com/smorky850612/Aurakit/tree/main/skills/aura
- **Website:** https://aurakit.aurax-dev.workers.dev/

## Install

```sh
agentstack add skill-smorky850612-aurakit-aura
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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/` 프로젝트 데이터는 유지됨.

```bash
# 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 한도 소진.

| 태스크 | 주요 모드 | 이유 |
|--------|---------|------|
| Scout (탐색·프로파일링·파일 탐색) | 전체 | 읽기 전용, 패턴 매칭 |
| Discovery 초기 스캔 (기존 코드 탐색) | BUILD | 읽기 전용 탐색 |
| Micro-plan 초안 (파일 목록, 200토큰) | BUILD | 단순 목록 생성 |
| V3 TestRunner (테스트 실행+결과 보고) | BUILD/FIX/TDD | 명령 실행+결과 집계 |
| Worker-C (테스트 실행) | REVIEW | 명령 실행+결과 집계 |
| Worker-D (Gap 분석·Match Rate) | REVIEW | 단순 비교 |
| GapDetector (반복 Match Rate 측정) | ITERATE | 단순 비교 |
| PM-Research / Discovery / Strategy | PM | 정형 템플릿 채우기 |
| Worker-UI (컴포넌트 트리 목록) | DESIGN (ECO) | 구조 목록 생성 |
| Cross-Check Worker (설계 일관성 비교) | DESIGN | 단순 비교 |
| 스냅샷 파일 쓰기 (.aura/snapshots/) | BUILD/FIX | 단순 파일 쓰기 |
| Instinct 패턴 추출 및 저장 | BUILD/FIX 후 | 패턴 기록 |
| 완료 리포트 초안 (템플릿 채우기) | 전체 | 정형 템플릿 채우기 |
| bloat-check 결과 분석 | BUILD/REVIEW | 줄 수 집계 |
| Convention 패턴 체크 출력 | BUILD | 패턴 매칭 |

**Agent 호출 형식 (Claude Code — ECO/PRO 필수):**
```
Agent(
  subagent_type: "general-purpose",
  model: "haiku",          ← 반드시 명시 (생략 시 Sonnet 기본값)
  description: "[3-5단어 설명]",
  prompt: "[구체적 지시 + Fail-Only 출력 요청]"
)
```

> 💡 `CLAUDE_CODE_SUBAGENT_MODEL=claude-haiku-4-5-20251001` 환경변수 설정 시
> model 파라미터 생략해도 자동으로 Haiku 사용. 미설정 시 명시 필수.

---

## C. 공통 프로토콜 (모든 모드 — 필수)

> ⚠️ B-0 속도 체크 → B-1~B-4 필수, B-5 권장. 실패 시 작업 중단. 상세 → `resources/common-protocol.md`

**B-0. 세션 캐시** [v5.0 — 속도 최적화, 먼저 실행]
- `.aura/runtime/session.json` 존재 + 2시간 이내 → B-1, B-5 스킵 (이미 로딩됨)
- 세션 첫 실행만 전체 프로토콜 실행 → 이후 빠른 시작
- ⚠️ Windows: `date -r` 미지원 → 캐시 자동 건너뜀 (전체 프로토콜 실행, 기능 영향 없음)

**B-1. 프로젝트 프로필** [필수]
- `.aura/project-profile.md` 확인
- 없으면: `Agent(model:"haiku")` Scout 실행 → `.aura/project-profile.md` + `.aura/design-system.md` 생성
- v5.0: ConfigHash 캐시 — `md5sum package.json go.mod pyproject.toml Dockerfile 2>/dev/null | md5sum` → 변경 시만 재실행
- ⚠️ Windows cmd.exe: `md5sum` 미지원 → Git Bash 사용 또는 캐시 건너뜀

**B-2. 보안 L5+L6 점검** [필수]
- `.aura/` 존재 + `.env` → `.gitignore` 포함 확인 (L5 기준선)
- BUILD/FIX: `npm audit --audit-level=high` 자동 실행 (L6)

**B-3. 디자인 시스템** [UI 파일 생성 시]
- `.aura/design-system.md` 로딩. 없으면 default 복사. CSS 토큰 필수.

**B-4. 세션 재개 + 스냅샷 복구** [필수]
- `.aura/snapshots/current.md` 존재 시 → 이전 작업 상태 표시:
  ```
  📋 이전 작업 감지:
     모드: BUILD | 상태: 5/8 파일 완료 | 마지막: src/auth/login.tsx
     ▶ 이어서 진행할까요? (Y/N)
  ```
- 이전 파이프라인 흐름이 있으면 다음 단계 제안:
  ```
  💡 지난 세션: BUILD 완료 → 다음 권장: /aura review
  ```

**B-5. 크로스세션 메모리 + Instinct + 글로벌 학습** [v6]
- `.aura/memory.md` → 아키텍처 결정사항 로딩
- `.aura/team/` → decisions.md(ADR 형식), conventions.md, glossary.md
- `.aura/instincts/` → 프로젝트 학습 패턴 로딩 (score > 40, 상위 5개)
- **[v6 신규]** `~/.claude/.aura/global-instincts/` → 전체 프로젝트 공유 패턴 자동 로딩
  - 현재 프로젝트 언어/프레임워크 매칭 글로벌 패턴 상위 3개 로딩
  - 로컬 instinct score ≥ 60 → 글로벌 자동 승격 (민감 정보 자동 제거)
  - 설치된 PC의 모든 프로젝트가 공유 → 쓸수록 점점 똑똑해짐
- 상세 → `resources/instinct-system.md`

---

## D. BUILD 모드

> 상세 → `resources/build-pipeline.md` · `resources/security-rules.md` · `resources/discovery-protocol.md`

1. **Discovery** [필수] — 5체크: 실제 문제 / 기존 코드 / YAGNI / 범위 / 성공 기준
2. **마이크로 플랜** (200 토큰) — 파일 목록 + 의존성 순서
3. **파일별 구현** — API(try-catch+응답 포맷) · SQL(parameterized) · 접근성(alt/label) · 안전한 인증 방식 · 250줄 제한 · CSS 토큰 · Atomic Design · App Router 패턴 · 상태 관리 가이드 · v5.0: 언어별 리뷰어 자동 적용(`resources/language-reviewers.md`) · 프레임워크 패턴 자동 적용(`resources/framework-patterns.md`) · Instinct 패턴 참고
4. **스냅샷 기록** — 파일 완료마다 `.aura/snapshots/current.md` 업데이트
5. **3중 검증** — V1(빌드) + V2(Reviewer+Security, `Agent(model:"sonnet")`) + V3(TestRunner, `Agent(model:"haiku")`), V2+V3 병렬; V1 실패 시 → 언어별 Build Resolver 자동 실행 (`resources/build-resolvers.md`)
6. **보안 L5** — security-scan.sh pre-commit hook 자동
7. **Convention Check** — convention-check.sh (CONV-001~005) 자동 [v4.0]
8. **커밋** — `git commit -m "feat(scope): description"`
9. **완료 리포트 + 다음 제안** — 자동 Next Actions 표시 (Section V 참조)

---

## E. FIX 모드

> 상세 → `resources/fix-pipeline.md`

에러 파싱 → Scout 탐색 → 근본 원인 파악 → 최소 변경 → 3중 검증 → `fix(scope):` 커밋
- **Build Resolver 자동**: V1 실패 → project-profile.md 언어 감지 → 언어별 Resolver 에이전트 (`resources/build-resolvers.md`)

---

## F. CLEAN 모드

> 상세 → `resources/clean-pipeline.md`

bloat-check.sh → 중복 탐색 → dead code 제거 → 250줄 초과 분할 → 3중 검증 → `refactor(scope):` 커밋

---

## G. DEPLOY 모드

> 상세 → `resources/deploy-pipeline.md` · Enterprise → `resources/deploy-enterprise.md`

프레임워크 감지 → `.env.example` 생성 → 배포 설정 파일 → 보안 L5 재검사 → `chore(deploy):` 커밋
Enterprise: K8s(Deployment/HPA/Ingress) + Terraform(AWS ECS+RDS) + GitHub Actions + ArgoCD

---

## H. REVIEW · GAP 모드

> 상세 → `resources/review-pipeline.md` · GAP → `resources/gap-check.md`

Worker-A(Reviewer, sonnet) + Worker-B(SecurityAgent, sonnet) + Worker-C(TestRunner, haiku) + Worker-D(GapDetector, haiku)
→ 4에이전트 병렬 → 통합 리포트 (VULN-NNN 형식, A~F 등급, Match Rate %)

---

## I. ITERATE 모드

> 상세 → `resources/iterate-pipeline.md`

GapDetector(ECO/PRO: haiku, MAX: sonnet) → Match Rate ≥90%: 완료 /  상세 → `resources/tdd-pipeline.md`

🔴 RED(TDD-Writer, sonnet) → TestRunner 실패 확인 → 🟢 GREEN(Builder) → TestRunner 통과 → 🔵 REFACTOR(Reviewer) → 커버리지 ≥70%(ECO) / ≥80%(PRO) / ≥90%(MAX)

---

## K. PM 모드

> 상세 → `resources/pm-pipeline.md`

빠른: `PM-Discovery(haiku) + PM-Strategy(haiku)` 병렬 → `PM-PRD(sonnet)`
전체: `PM-Research(haiku)` 먼저 → 빠른 모드 흐름 → BUILD 전환 선택

---

## L. PLAN · DESIGN · REPORT

> 상세 → `resources/plan-pipeline.md` · `resources/design-pipeline.md` · `resources/report-pipeline.md`

```
/aura plan:[기능명]    → .aura/docs/plan-*.md
/aura design:[기능명]  → .aura/docs/design-*.md
/aura report:[기능명]  → .aura/docs/report-*.md
```

**DESIGN v5.0**: Worker-DB(sonnet) + Worker-API(sonnet) + Worker-UI(haiku) 병렬 → Cross-Check Worker(haiku) 자동 DB↔API↔UI 일관성 검증
**REPORT v5.0**: 4관점 가치 분석표 (사용자/비즈니스/기술/운영) 포함

권장 순서: PM → PLAN → DESIGN → BUILD → REVIEW → ITERATE → REPORT

---

## M. 확장 모드

| 모드 | 상세 리소스 | 주요 기능 |
|------|------------|---------|
| PIPELINE | `pipeline-guide.md` | Starter/Dynamic/Enterprise 9단계 가이드 |
| STYLE | `style-guide.md` | learning/expert/concise 페르소나 전환 |
| SNIPPETS | `snippets-guide.md` | 프롬프트 라이브러리 저장·재사용 |
| QA | `qa-pipeline.md` | Zero-Script QA, docker log 기반 검증 |
| QA:E2E | `e2e-pipeline.md` | Playwright E2E — setup/auth/CRUD/반응형/CI (qa:e2e:setup, qa:e2e:ci) |
| DEBUG | `systematic-debugging.md` | 4-Phase 체계적 디버깅 (5-WHY) |
| BRAINSTORM | `brainstorming.md` | HMW + 우선순위 매트릭스 |
| ORCHESTRATE | `orchestration-patterns.md` | Leader/Swarm/Council/Watchdog |
| MOBILE | `mobile-pipeline.md` | React Native/Expo 전문 가이드 |
| DESKTOP | `desktop-pipeline.md` | Electron/Tauri 전문 가이드 |
| BAAS | `baas-pipeline.md` | Supabase/Firebase/bkend 전문 가이드 |
| **CONTENT** | `business-skills.md` | 블로그·시장조사·IR덱·기술문서·이메일·SNS |
| **INSTINCT** | `instinct-system.md` | 학습 패턴 관리 · 팀 공유 · 자동 성장 · instinct:evolve |
| **LANG** | `language-reviewers.md` | TS/Python/Go/Java/Rust/Kotlin/C++/Swift/PHP/Perl + 프레임워크별 리뷰 (10언어) |
| **MCP** | `mcp-configs.md` | 14종 MCP 서버 설정 (mcp:setup, mcp:list, mcp:check, mcp:add) |
| **LOOP** | `loop-pipeline.md` | 자율 반복 루프 (until:pass·90%·no-error, max:N, 격리 실행) |
| **BUILD_RESOLVER** | `build-resolvers.md` | 언어별 빌드 에러 해결 (Go/Rust/Java/Kotlin/C++/Swift/Python) |
| **STATUS:HEALTH** | `status-dashboard.md` | Health Dashboard — Match Rate · 보안 점수 · 커버리지 · Tech Debt |
| **PAYMENT** | `payment-pipeline.md` | Stripe · LemonSqueezy · Polar · TossPayments · StepPay 구독 결제 완성 (기본 PRO 티어) |
| **SPEC** | `autopus-spec-system.md` | EARS 형식 SPEC (spec.md + acceptance.md + plan.md), Given/When/Then 인수 기준 |
| **LORE** | `autopus-lore-commit.md` | 9-trailer 결정 추적 커밋 (Constraint/Rejected/Confidence/Scope-risk/Reversibility/Directive/Tested/Not-tested/Related) |
| **AX/ANNOTATE** | `autopus-ax-annotation.md` | @AX 코드 어노테이션 시스템 (NOTE/WARN/ANCHOR/TODO, [AUTO] 접두사, CYCLE 추적) |
| **PIPELINE_V2** | `autopus-pipeline-v2.md` | 5단계 파이프라인 v2 (Phase 1.5 테스트 스캐폴드, 1.8 문서 페치, 2.5 어노테이션, 3.5 UX 검증, RALF 루프) |
| **EXECUTOR_PROFILES** | `autopus-executor-profiles.md` | 스택별 실행 프로필 (Go/TypeScript/Python/Rust/Frontend) |
| **VALIDATOR_GATES** | `autopus-validator-gates.md` | Gate 2 8개 체크 (빌드/테스트/린트/커버리지/구조/시임 탐지/승인 커버리지/마이그레이션) |
| **EXPERIMENT** | `autopus-experiment-loop.md` | XLOOP 자율 개선 루프 (메트릭 기반 변경 → 유지/폐기 → 서킷 브레이커) |
| **AGENT_TEAMS** | `autopus-agent-teams.md` | Lead/Builder/Guardian 팀 구조, SendMessage 패턴, 서브에이전트 폴백 |
| **WORKTREE_RULES** | `autopus-worktree-isolation.md` | Worktree 격리 R1-R7 (충돌 감지 3체크, GC 억제, 지수 백오프) |

---

## N. STATUS · HEALTH · CONFIG

> 상세 → `resources/config-schema.md` (config 전체 스키마)

```bash
/aura status           → .aura/snapshots/current.md 기반 현황
/aura status:health    → Health Dashboard (resources/status-dashboard.md)
/aura config:show      → .aura/config.json 현재 설정
/aura config:set tier=pro  → 기본 티어 변경
/aura next             → 다음 추천 작업
```

Health Dashboard: Match Rate · 보안 점수 · 테스트 커버리지 · Tech Debt · Doc Lifecycle 인덱스

---

## O. ARCHIVE · BATCH · FINISH

> 상세 → `resources/archive-pipeline.md` · `resources/batch-pipeline.md` · `resources/branch-finishing.md`

```bash
/aura archive:[기능]                          → .aura/archive/ 보관 (삭제 아님)
/aura archive:list                            → 보관 목록
/aura batch:[A,B,C]                          → 병렬 처리 (최대 5개, 각각 Git Worktree)
/aura batch:sequential:A,B                   → 순차 처리
/aura batch:loop:[작업] until:pass max:5     → 자율 반복 (resources/loop-pipeline.md)
/aura batch:status                           → 진행 중인 배치 작업 상태 확인
/aura batch:recover                          → 실패 Worktree 정리 + 성공분 머지 제안
/aura finish:                                 → squash merge + Worktree 정리
/aura rollback:                              → 변경사항 안전하게 되돌리기 (확인 후 git reset)
/aura uninstall                              → AuraKit 훅 설정 제거 (settings.json 복구)
```

---

## P. 필수 규칙 (Mandatory — 위반 시 차단)

| 규칙 | 위반 결과 |
|------|----------|
| SQL: parameterized query | security-scan.sh 차단 |
| 안전한 인증 방식 사용 | security-scan.sh 차단 |
| 시크릿 하드코딩 금지 | security-scan.sh 차단 |
| V1 빌드 검증 필수 | build-verify.sh 차단 |
| Discovery → 플랜 → 구현 순서 | 순서 건너뛰면 재시작 |
| 컴포넌트 250줄 초과 즉시 분할 | bloat-check.sh 경고 |
| CONV-001~005 HIGH 위반 | convention-check.sh 차단 |
| 핵심 보안 규칙 항상 활성 | `~/.claude/rules/aurakit-security.md` (모든 세션, /aura 불필요) |
| ECO/PRO 티어 Haiku 태스크를 Sonnet 직접 실행 | THRIFTY 위반 → 즉시 Haiku Agent 위임으로 수정 |

---

## Q. 토큰 절감 메커니즘

> 모든 절감 수치는 추정치. context load 크기(v5.1 82KB → v6 20KB)는 실측값.

Tiered Model(~40%) · Fail-Only(~30%) · Quick Mode(~60%) · Cache Guard(~20%) · Progressive Load(~10%) · ConfigHash(~10%) · Context Isolation(~15%)

**토큰 표시**: `💰 [티어] | 컨텍스트: [Y]% | 오늘: ↑[N] ↓[N] = [total]([N]회) | 주간: [N] | 다음: [제안]`

---

## R. 에러 처리

| 상황 | 대응 |
|----

…

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [smorky850612](https://github.com/smorky850612)
- **Source:** [smorky850612/Aurakit](https://github.com/smorky850612/Aurakit)
- **License:** MIT
- **Homepage:** https://aurakit.aurax-dev.workers.dev/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-smorky850612-aurakit-aura
- Seller: https://agentstack.voostack.com/s/smorky850612
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.