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/qa-pipeline.md

View on GitHub
# AuraKit — QA Pipeline (G7)

> 이 파일은 `/aura qa:` 모드 또는 `/aura review:` 완료 후 QA 단계에서 로딩된다.

---

## 개요: Zero-Script QA + Log-Based Testing

테스트 스크립트 없이 실제 실행 로그로 검증하는 방법.
Docker 로그, API 응답, 브라우저 콘솔을 활용한 구조화된 QA.

```bash
# QA 모드 진입
/aura qa:                      → 현재 변경사항 전체 QA
/aura qa:api                   → API 엔드포인트 집중 QA
/aura qa:ui                    → UI 컴포넌트 QA
/aura qa:security              → 보안 취약점 QA
/aura qa:performance           → 성능 QA
/aura qa:e2e                   → E2E 테스트 (Playwright)
/aura qa:e2e:setup             → playwright.config.ts + 시나리오 자동 생성
/aura qa:e2e:ci                → GitHub Actions E2E 워크플로우 생성
```

---

## Step 1: QA 범위 결정

```bash
# 변경된 파일 감지
git diff --name-only HEAD~1 HEAD

# 파일 유형별 QA 전략:
*.ts / *.tsx → TypeScript + 단위 테스트
*api*        → API 엔드포인트 테스트 (curl)
*component*  → 컴포넌트 렌더링 + 접근성
*service*    → 비즈니스 로직 단위 테스트
*.sql        → 쿼리 결과 검증
Dockerfile   → 컨테이너 빌드 + 실행 테스트
```

---

## Step 2: 빠른 자동 검증 (항상 실행)

### 2.1 빌드 검증 (V1)

```bash
# TypeScript
npx tsc --noEmit

# Python
python -m py_compile **/*.py

# Go
go build ./...
```

### 2.2 린트 + 포맷

```bash
# Node.js
npx eslint . --ext .ts,.tsx --max-warnings 0
npx prettier --check .

# Python
ruff check .

# 실패 시: 자동 FIX 모드 전환
```

### 2.3 단위 테스트 (V3)

```bash
# Node.js
npx vitest run --reporter=verbose
# 또는
npx jest --ci

# Python
pytest --tb=short -v

# Go
go test ./... -v

# 결과 파싱:
# [N] tests passed, [N] failed, [N] skipped
# coverage: [N]%
```

---

## Step 3: Zero-Script QA (API)

테스트 코드 없이 실제 API 호출로 검증.

### 3.1 서버 기동

```bash
# 개발 서버 백그라운드 시작
npm run dev &
DEV_PID=$!

# 준비 대기 (최대 30초)
for i in $(seq 1 30); do
  curl -s http://localhost:3000/health && break
  sleep 1
done
```

### 3.2 API 엔드포인트 체크리스트

```bash
BASE="http://localhost:3000/api"

# 인증 없이 보호된 라우트 → 401 확인
curl -s -o /dev/null -w "%{http_code}" $BASE/users
# 기대: 401

# 잘못된 입력 → 400 확인
curl -s -X POST $BASE/users \
  -H "Content-Type: application/json" \
  -d '{"email":"invalid"}' | jq .
# 기대: {"success":false,"error":"validation_failed"}

# 정상 흐름 → 200 확인
TOKEN=$(curl -s -X POST $BASE/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"test@test.com","password":"test1234"}' | jq -r .token)

curl -s $BASE/users \
  -H "Authorization: Bearer $TOKEN" | jq .
# 기대: {"success":true,"data":[...]}
```

### 3.3 응답 포맷 검증

```bash
# 표준 응답 포맷 검사 (AuraKit 규칙)
RESPONSE=$(curl -s $BASE/users -H "Authorization: Bearer $TOKEN")

echo $RESPONSE | jq 'has("success")' # true 확인
echo $RESPONSE | jq '.success'        # true/false
echo $RESPONSE | jq 'has("data")'    # true 확인
```

---

## Step 3.5: E2E 테스트 (Playwright)

> `/aura qa:e2e` 입력 시 → `resources/e2e-pipeline.md` 로딩 → Playwright 자동 실행.

```bash
/aura qa:e2e:setup            # playwright.config.ts + 시나리오 생성
/aura qa:e2e                  # 전체 E2E 스위트 실행
/aura qa:e2e:auth             # 인증 플로우만 실행
/aura qa:e2e:[url]            # 특정 URL 집중 테스트
```

### 자동 생성 시나리오

```
1. 인증: 회원가입 → 로그인 → 로그아웃
2. CRUD: 생성 → 조회 → 수정 → 삭제
3. 반응형: mobile(375px) · tablet(768px) · desktop(1440px)
4. 보안: 비인증 → 보호 라우트 → 리다이렉트 확인
```

### 실패 분석 패턴

```
TimeoutError: 셀렉터 없음 → locator 수정 또는 대기 조건 추가
NetworkError: baseURL 확인 → NEXT_PUBLIC_URL 환경변수 점검
AssertionError: URL 불일치 → 리다이렉트 로직 점검
```

상세 → `resources/e2e-pipeline.md`

---

## Step 4: Docker Log-Based QA

### 4.1 컨테이너 실행 + 로그 모니터링

```bash
# 컨테이너 빌드 + 실행
docker compose up -d

# 실시간 로그 구조화 출력
docker compose logs -f --tail=100 | jq -R '
  . as $line |
  if test("^{") then fromjson
  else {"raw": $line}
  end
' 2>/dev/null || docker compose logs -f --tail=100
```

### 4.2 구조화 로그 포맷 (AuraKit 표준)

애플리케이션에서 이 포맷으로 로그를 출력해야 Zero-Script QA 가능:

```json
{"level":"info","event":"request","method":"POST","path":"/api/users","status":201,"ms":23}
{"level":"error","event":"validation","field":"email","message":"invalid format"}
{"level":"warn","event":"auth","message":"invalid token","ip":"::1"}
```

```bash
# 에러 로그만 필터링
docker compose logs | grep '"level":"error"' | jq .

# 느린 요청 감지 (200ms 이상)
docker compose logs | jq -R '
  if test("^{") then fromjson | select(.ms > 200)
  else empty end
' 2>/dev/null
```

### 4.3 로그 기반 테스트 시나리오

```bash
# 시나리오 실행 + 로그 캡처
docker compose logs -f > /tmp/qa-log.txt &
LOG_PID=$!

# 시나리오 1: 회원가입 → 로그인 → 데이터 조회
curl -s -X POST http://localhost:3000/api/auth/signup \
  -d '{"email":"qa@test.com","password":"qa123456"}'

sleep 2
kill $LOG_PID

# 로그 분석
grep -c '"event":"request"' /tmp/qa-log.txt   # 요청 수
grep '"level":"error"' /tmp/qa-log.txt         # 에러 있으면 실패
```

---

## Step 5: UI QA 체크리스트

### 5.1 접근성 (WCAG 2.1 AA)

```
□ 모든 이미지에 alt 속성
□ 폼 입력에 htmlFor / aria-label
□ 버튼에 aria-label (아이콘만 있을 때)
□ 키보드 탭 순서 논리적
□ 색상 대비 4.5:1 이상
□ Focus visible 스타일 존재
```

### 5.2 반응형 체크포인트

```
□ 320px (모바일 최소)
□ 768px (태블릿)
□ 1024px (데스크톱 작은)
□ 1440px (데스크톱 큰)
```

### 5.3 브라우저 콘솔 에러

```javascript
// 브라우저 콘솔에서 실행
const errors = [];
const originalError = console.error;
console.error = (...args) => { errors.push(args); originalError(...args); };

// 페이지 조작 후
console.log('에러 수:', errors.length);
// 0이어야 통과
```

---

## Step 6: 보안 QA (L3)

```
□ 인증 없이 보호 라우트 접근 → 401 반환 확인
□ 다른 사용자 리소스 접근 → 403 반환 확인
□ SQL Injection 입력 → 에러 노출 없이 400 반환
□ XSS 입력 ("<script>") → HTML 이스케이프 확인
□ CSRF 토큰 검증 (상태 변경 요청)
□ Rate Limiting 동작 확인 (429 반환)
□ 에러 응답에 스택 트레이스 미포함 확인
```

---

## Step 7: 성능 QA

```bash
# API 응답시간 측정
time curl -s $BASE/users -H "Authorization: Bearer $TOKEN" > /dev/null

# 기준:
# < 100ms → A (우수)
# < 300ms → B (양호)
# < 1000ms → C (개선 권장)
# > 1000ms → D (필수 개선)

# 번들 사이즈 (Next.js)
npx next build 2>&1 | grep "First Load JS"

# 기준:
# < 100KB → A
# < 200KB → B
# < 400KB → C
# > 400KB → D
```

---

## QA 에이전트 배분

```
QA-Coordinator (sonnet/opus(MAX)):
  → QA 범위 결정
  → 체크리스트 생성

동시 실행:
  QA-API (haiku/sonnet(MAX)):      → API 엔드포인트 테스트
  QA-UI (haiku/sonnet(MAX)):       → 접근성 + 반응형 검사
  QA-Security (sonnet/opus(MAX)):  → 보안 L3 검사
  QA-Performance (haiku/sonnet(MAX)): → 성능 측정

QA-Monitor (haiku):
  → Docker 로그 실시간 분석
  → 이상 패턴 감지

E2E-Worker (haiku/sonnet(MAX)):
  → /aura qa:e2e 실행 시 활성화
  → playwright 시나리오 실행 + 실패 스크린샷 분석

종합자 (sonnet/opus(MAX)):
  → 결과 통합
  → QA 리포트 생성
```

---

## QA 리포트 포맷

```markdown
# AuraKit QA Report
생성: [타임스탬프]
범위: [N]개 파일 / [N]개 엔드포인트

## 자동 검증
V1 (빌드): ✅ Pass
V3 (테스트): ✅ [N/N Pass] | 커버리지: [N]%

## API QA
✅ POST /api/auth/login → 200 (23ms)
✅ GET /api/users (인증 없음) → 401
❌ DELETE /api/users/:id → 500 (에러 노출)

## E2E
✅ 인증 플로우: 회원가입 → 로그인 → 로그아웃 (2.3s)
✅ 반응형: mobile · tablet · desktop Pass
⚠️ CRUD 삭제 버튼: locator 타임아웃 → 수동 확인 필요

## 접근성
⚠️ src/components/UserAvatar.tsx:12 — img에 alt 없음

## 보안
✅ SQL Injection → 안전
✅ XSS → 이스케이프 확인
⚠️ Rate Limiting 미구현

## 성능
API 평균 응답시간: 87ms (A)
번들 사이즈: 156KB (B)

## 결론
등급: B | 주요 이슈: 2개 (에러 노출, Rate Limiting)
권장: /aura fix:API 500 에러 수정
```
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: 194kUpdated Claude CodeCodexVerifiedInstall