Skip to content

smorky850612/Aurakit / skills/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.

FileKindSize
SKILL.mdskill md29.2 KB
resources/agent-security.mdmarkdown4.2 KB
resources/agent-spawning.mdmarkdown5.9 KB
resources/agent-team.mdmarkdown5.7 KB
resources/archive-pipeline.mdmarkdown3.5 KB
resources/autopus-agent-teams.mdmarkdown6.8 KB
resources/autopus-ax-annotation.mdmarkdown6.1 KB
resources/autopus-executor-profiles.mdmarkdown9.9 KB
resources/autopus-experiment-loop.mdmarkdown5.9 KB
resources/autopus-lore-commit.mdmarkdown6.0 KB
resources/autopus-pipeline-v2.mdmarkdown8.5 KB
resources/autopus-spec-system.mdmarkdown4.8 KB
resources/autopus-validator-gates.mdmarkdown7.0 KB
resources/autopus-worktree-isolation.mdmarkdown4.6 KB
resources/baas-pipeline.mdmarkdown3.8 KB
resources/batch-pipeline.mdmarkdown4.9 KB
resources/brainstorming.mdmarkdown4.7 KB
resources/branch-finishing.mdmarkdown4.7 KB
resources/build-pipeline.mdmarkdown12.0 KB
resources/build-resolvers-cpp.mdmarkdown10.0 KB
resources/build-resolvers-go.mdmarkdown1.2 KB
resources/build-resolvers-java.mdmarkdown9.1 KB
resources/build-resolvers-kotlin.mdmarkdown8.7 KB
resources/build-resolvers-python.mdmarkdown9.0 KB
resources/build-resolvers-rust.mdmarkdown1.2 KB
resources/build-resolvers-swift.mdmarkdown11.9 KB
resources/build-resolvers.mdmarkdown1.6 KB
resources/business-skills.mdmarkdown7.0 KB
resources/cache-engineering.mdmarkdown6.6 KB
resources/clean-pipeline.mdmarkdown6.5 KB
resources/common-protocol.mdmarkdown7.4 KB
resources/config-schema.mdmarkdown3.0 KB
resources/cross-harness.mdmarkdown16.6 KB
resources/deploy-enterprise.mdmarkdown9.0 KB
resources/deploy-pipeline.mdmarkdown6.9 KB
resources/design-pipeline.mdmarkdown3.2 KB
resources/desktop-pipeline.mdmarkdown3.5 KB
resources/discovery-protocol.mdmarkdown3.3 KB
resources/e2e-pipeline.mdmarkdown7.7 KB
resources/explain-pipeline.mdmarkdown972 B
resources/fix-pipeline.mdmarkdown5.6 KB
resources/framework-patterns.mdmarkdown8.3 KB
resources/gap-check.mdmarkdown3.4 KB
resources/install-guide.mdmarkdown3.4 KB
resources/instinct-system.mdmarkdown6.8 KB
resources/iterate-pipeline.mdmarkdown2.5 KB
resources/language-reviewers.mdmarkdown18.5 KB
resources/loop-pipeline.mdmarkdown3.5 KB
resources/mcp-configs.mdmarkdown4.7 KB
resources/migrate-pipeline.mdmarkdown1.5 KB
resources/mobile-pipeline.mdmarkdown3.5 KB
resources/mode-reference.mdmarkdown6.1 KB
resources/model-routing.mdmarkdown9.1 KB
resources/orchestration-patterns.mdmarkdown5.9 KB
resources/payment-lemonsqueezy.mdmarkdown5.6 KB
resources/payment-pipeline.mdmarkdown10.6 KB
resources/payment-polar.mdmarkdown3.6 KB
resources/payment-steppay.mdmarkdown4.8 KB
resources/payment-stripe.mdmarkdown6.7 KB
resources/payment-toss.mdmarkdown7.2 KB
resources/pipeline-guide.mdmarkdown6.1 KB
resources/plan-pipeline.mdmarkdown2.4 KB
resources/pm-pipeline.mdmarkdown4.5 KB
resources/qa-pipeline.mdmarkdown8.8 KB
resources/report-pipeline.mdmarkdown3.0 KB
resources/review-pipeline.mdmarkdown8.0 KB
resources/rollback-pipeline.mdmarkdown1.3 KB
resources/security-rules.mdmarkdown17.5 KB
resources/snippets-guide.mdmarkdown4.6 KB
resources/status-dashboard.mdmarkdown5.3 KB
resources/style-guide.mdmarkdown2.7 KB
resources/systematic-debugging.mdmarkdown5.7 KB
resources/tdd-pipeline.mdmarkdown4.4 KB

resources/review-pipeline.md

View on GitHub
# AuraKit — REVIEW Pipeline (상세)

> 이 파일은 REVIEW 모드에서만 로딩된다. (Progressive Disclosure)

---

## 원칙 (Mandatory — 위반 시 재실행)

- **객관적 측정**: 점수 기반 리포트 (A~F) [필수]
- **실행 가능한 피드백**: 파일:라인 + 수정 제안 [필수]
- **Tiered Model**: Worker-A/B → sonnet/opus(MAX), Worker-C/D → haiku/sonnet(MAX) (비용 ~40% 절감, ECO 기준) [필수]
- **병렬 실행**: Worker 에이전트 4개 동시 실행 (격리 서브에이전트) [필수]

---

## Step 1: 변경 파일 감지

```bash
# 커밋되지 않은 변경 파일
git diff --name-only

# 마지막 커밋의 변경 파일
git diff --name-only HEAD~1 HEAD

# 특정 브랜치와 비교
git diff --name-only main...feature/my-branch
```

사용자가 특정 파일/디렉토리를 지정한 경우 해당 범위만 리뷰.
지정하지 않은 경우: `git diff --name-only` 결과 사용.

---

## Step 2: Worker 에이전트 4개 병렬 실행 [Tiered Model, 필수]

```
Worker-A: 코드 리뷰     Agent(model="sonnet") — ECO/PRO 기준
Worker-B: 보안 L3 스캔  Agent(model="sonnet") — ECO/PRO 기준
Worker-C: 테스트 실행   Agent(model="haiku")  ← ECO/PRO 필수 (Sonnet 실행 금지)
Worker-D: Gap 분석      Agent(model="haiku")  ← ECO/PRO 필수 (Sonnet 실행 금지)

→ 4개 동시 실행 [필수], 결과 취합
→ 성공 시 "Pass" 한 줄 반환 (Fail-Only Output)
```

### Worker-A: 코드 리뷰 체크리스트

```
코드 품질:
  □ 에러 핸들링 — try-catch, error boundary
  □ 입력 검증 — 모든 사용자 입력 검증 여부
  □ 타입 안정성 — any 타입, 타입 캐스팅 남용
  □ 네이밍 — 의미있는 이름, 일관성
  □ 중복 코드 — DRY 원칙
  □ 컴포넌트 크기 — 250줄 이내
  □ 단일 책임 — 함수/컴포넌트가 한 가지 일만
  □ loading/error 상태 — UI 처리
  □ 접근성 — alt, label, ARIA

성능:
  □ 불필요한 리렌더링 — React.memo, useMemo, useCallback
  □ N+1 쿼리 패턴 — DB 쿼리 최적화 필요 여부
  □ 번들 사이즈 — 불필요한 import
```

### Worker-B: 보안 L3 스캔 체크리스트

```
인젝션:
  □ SQL Injection — parameterized query 사용 여부
  □ XSS — dangerouslySetInnerHTML, innerHTML 사용 여부
  □ Command Injection — exec(), spawn() 입력 검증
  □ Path Traversal — 파일 경로 검증

인증/인가:
  □ 인증 미들웨어 — 보호 라우트 커버리지
  □ 토큰 저장 — localStorage 저장 여부
  □ CSRF 보호 — 상태 변경 요청
  □ 권한 검사 — 리소스 소유권 확인

시크릿:
  □ 하드코딩된 시크릿 — API_KEY, SECRET 패턴
  □ 클라이언트 노출 — NEXT_PUBLIC_ 시크릿
  □ 로그 노출 — console.log(sensitiveData)

네트워크:
  □ CORS 설정 — 와일드카드 *
  □ Rate Limiting — 구현 여부
  □ 보안 헤더 — CSP, X-Frame-Options
```

### Worker-C: 테스트 실행

```bash
# Node.js
npm test
# 또는
npx vitest run
npx jest --ci

# Python
pytest --tb=short

# 결과:
# N tests passed, N failed, N skipped
# coverage: N%
```

---

## Step 5: bloat-check.js 실행

```bash
# 250줄 초과 파일 감지
find src -name "*.ts" -o -name "*.tsx" -o -name "*.py" | \
  xargs wc -l | sort -rn | awk '$1 > 250 {print $1, $2}'
```

---

## Step 6: 통합 리포트 생성

### 리포트 포맷

```markdown
# AuraKit Review Report
생성 시각: 2025-01-15T17:00:00Z
리뷰 범위: git diff HEAD~1 HEAD (4 files)

---

## 🔴 보안 이슈

### VULN-001 [HIGH] SQL Injection 취약점
- 위치: `src/app/api/search/route.ts:34`
- 심각도: HIGH
- 설명: 사용자 입력이 SQL 쿼리에 직접 삽입됨
- 현재 코드:
  ```typescript
  const results = await db.query(`SELECT * FROM products WHERE name = '${query}'`)
  ```
- 수정 제안:
  ```typescript
  const results = await db.query('SELECT * FROM products WHERE name = $1', [query])
  ```

### VULN-002 [MEDIUM] 인증 토큰 localStorage 저장
- 위치: `src/lib/auth.ts:78`
- 심각도: MEDIUM
- 설명: JWT 토큰을 localStorage에 저장하여 XSS 취약점 노출
- 수정 제안: httpOnly cookie 사용

---

## 🟡 코드 품질 이슈

### WARN-001 에러 핸들링 누락
- 위치: `src/components/UserList.tsx:45`
- 설명: async 함수에 try-catch 없음
- 수정 제안: ErrorBoundary로 감싸거나 try-catch 추가

### WARN-002 컴포넌트 크기 초과
- 위치: `src/components/Dashboard.tsx` (342줄)
- 설명: 250줄 초과
- 수정 제안: DashboardStats, DashboardChart로 분할

### WARN-003 미사용 import
- 위치: `src/lib/utils.ts:3`
- 설명: `import { debounce } from 'lodash'` — 미사용
- 수정 제안: 해당 import 제거

---

## 🟢 테스트 결과

총 24개 테스트:
- ✅ 22 Passed
- ❌ 2 Failed:
  - `UserService > createUser > should validate email format` (src/services/user.service.test.ts:45)
  - `AuthController > login > should reject invalid password` (src/controllers/auth.test.ts:89)

커버리지: 67.3% (목표: 80%)

---

## 📏 블로트 경고

| 파일 | 줄 수 | 권장 |
|------|-------|------|
| src/components/Dashboard.tsx | 342 | 분할 |
| src/app/api/users/route.ts | 289 | 분할 |

---

## 📊 전체 점수

| 항목 | 점수 |
|------|------|
| 보안 | D (HIGH 취약점 1개) |
| 코드 품질 | C (이슈 3개) |
| 테스트 | C (2 Failed, 커버리지 67%) |
| 블로트 | B (2개 파일 초과) |

**전체: C (수정 권장)**

---

## 🔧 권장 액션

우선순위 순:
1. `VULN-001` 즉시 수정 필요 — `/aura VULN-001 수정해줘`
2. `VULN-002` 수정 필요 — `/aura 토큰 저장 방식 수정해줘`
3. 실패한 테스트 수정 — `/aura 실패한 테스트 수정해줘`
4. Dashboard.tsx 분할 — `/aura Dashboard 컴포넌트 분할해줘`
```

---

## 점수 산정 기준

| 등급 | 보안 | 품질 | 테스트 |
|------|------|------|--------|
| A | 이슈 없음 | 이슈 없음 | 100% Pass + 80%+ 커버리지 |
| B | LOW 이슈만 | 1~2개 | 98%+ Pass |
| C | MEDIUM 이슈 | 3~5개 | 90%+ Pass |
| D | HIGH 이슈 | 6~10개 | 80%+ Pass |
| F | CRITICAL 이슈 | 10개 초과 | 80% 미만 |

---

## Step 7: Gap Check → ITERATE 자동 체인 [P1 신규]

리뷰 완료 후 자동 Gap Check 실행:

```
Gap Worker: Agent(model="haiku")  ← ECO/PRO 필수 (Sonnet 직접 실행 금지)
  → .aura/design-system.md vs 현재 구현 비교
  → Match Rate 계산

Match Rate ≥ 90% → 리뷰 완료, 커밋 권고
  → "✅ REVIEW 완료 — Match Rate N%. 커밋 후 /aura deploy: 권장"

Match Rate < 90% → 자동 ITERATE 모드 전환
  → "⚠️ Match Rate N% — ITERATE 모드로 자동 전환합니다"
  → resources/iterate-pipeline.md 로딩 → 최대 5회 자동 수정
```

**자동 체인 흐름:**
```
REVIEW → Gap Check → [Match Rate ≥90%] → 완료 리포트
                   → [Match Rate <90%]  → ITERATE (최대 5회) → 완료 리포트
```

이 체인은 자동으로 실행된다. 사용자 확인 없이 진행.
ITERATE 비활성화: `/aura review no-iterate:` 사용.

---

## Step 8: /simplify 자동 연결 [P2 신규]

ITERATE 완료(Match Rate ≥ 90%) 또는 리뷰 등급 A/B 달성 시:

```
Match Rate ≥ 90% AND 코드 품질 A/B → /simplify 권고
  → "✅ 코드 품질 양호 — /simplify로 최종 정리 권장"
  → 사용자 확인 후 실행 (자동 실행 아님)

/simplify 실행 내용:
  - 미사용 import/변수 제거
  - 중복 로직 통합
  - 네이밍 일관성 검사
  - 250줄 초과 파일 분할
  - 기능 변경 없이 구조만 개선
```

**흐름:**
```
REVIEW → Gap Check → ITERATE (필요 시) → ≥90% 달성
       → /simplify 권고 → 사용자 확인 → 정리 실행
       → 최종 커밋 → 완료 리포트
```

`/simplify` 비활성화: `/aura review no-simplify:` 사용.

---

## 완료 리포트 포맷

```
✅ AuraKit REVIEW 완료
범위: [N]개 파일
보안: [A/B/C/D/F] | 품질: [A/B/C/D/F] | 테스트: [N/N Pass]
Match Rate: [N]% → [자동 ITERATE 결과 있으면 표시]
Simplify: [실행됨/건너뜀]
다음: [권장 액션]
```
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 196kUpdated Claude CodeCodexVerifiedInstall