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

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

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

---

## Step 0.5: Discovery 초기 스캔 [ECO/PRO: Haiku 위임 필수]

```
Agent(model="haiku") 실행:  ← ECO/PRO 티어 필수, Sonnet 직접 실행 금지
  목적: 기존 구현 탐색 (YAGNI 기준선)
  탐색:
    - 유사한 기존 파일/컴포넌트 존재 여부
    - 관련 의존성, import 패턴
    - 프로젝트 구조 내 최적 배치 위치
  출력: "존재: [파일목록] / 없음: 새로 생성 필요" (Fail-Only)
```

---

## Step 1: 마이크로 플랜 (200 토큰 이내) [ECO/PRO: Haiku 위임 필수]

> 마이크로 플랜 초안은 Agent(model="haiku")로 생성. 메인 세션에서 직접 작성 금지.

### 출력 포맷

```
📋 BUILD PLAN — [기능명]

파일 목록 (의존성 순서):
1. [파일경로] — [역할 1줄]
2. [파일경로] — [역할 1줄]
3. [파일경로] — [역할 1줄]

의존성:
- [파일A] → [파일B] (파일B가 파일A에 의존)

예상 소요: [N]개 파일
```

### 플랜 생성 규칙
- 최소 파일로 최대 기능 구현 (YAGNI 원칙)
- 의존성 없는 파일은 독립 배치 (병렬 구현 가능)
- 각 파일 역할은 1줄 이내로 명확하게

---

## Step 2: 파일별 구현 규칙

### 2-1. API 엔드포인트 (Node.js / Next.js)

```typescript
// ✅ 올바른 패턴
export async function POST(req: Request) {
  try {
    const body = await req.json()

    // 입력 검증 (zod)
    const schema = z.object({
      email: z.string().email().max(255),
      password: z.string().min(8).max(128),
    })
    const parsed = schema.safeParse(body)
    if (!parsed.success) {
      return Response.json(
        { success: false, error: 'VALIDATION_ERROR', message: parsed.error.message },
        { status: 400 }
      )
    }

    // 비즈니스 로직
    const result = await doSomething(parsed.data)

    return Response.json({ success: true, data: result })
  } catch (error) {
    console.error('[API Error]:', error)
    return Response.json(
      { success: false, error: 'INTERNAL_ERROR', message: 'Something went wrong' },
      { status: 500 }
    )
  }
}

// ❌ 금지 패턴
// - try-catch 없음
// - 입력 검증 없음
// - 에러 정보 전체 노출
```

### 2-2. SQL 쿼리

```typescript
// ✅ Parameterized query
const result = await db.query(
  'SELECT * FROM users WHERE email = $1 AND active = $2',
  [email, true]
)

// ✅ Prisma (자동 parameterized)
const user = await prisma.user.findUnique({
  where: { email }
})

// ❌ 절대 금지 — SQL Injection 취약점
const result = await db.query(
  `SELECT * FROM users WHERE email = '${email}'`
)
```

### 2-3. React 컴포넌트

```typescript
// ✅ 올바른 패턴
'use client'

import { useState } from 'react'
import type { FC } from 'react'

interface Props {
  title: string
  onSubmit: (data: FormData) => Promise<void>
}

const MyForm: FC<Props> = ({ title, onSubmit }) => {
  const [isLoading, setIsLoading] = useState(false)
  const [error, setError] = useState<string | null>(null)

  const handleSubmit = async (e: React.FormEvent<HTMLFormElement>) => {
    e.preventDefault()
    setIsLoading(true)
    setError(null)
    try {
      const formData = new FormData(e.currentTarget)
      await onSubmit(formData)
    } catch (err) {
      setError(err instanceof Error ? err.message : '오류가 발생했습니다')
    } finally {
      setIsLoading(false)
    }
  }

  return (
    <form onSubmit={handleSubmit} noValidate>
      <h2>{title}</h2>
      {/* 접근성: label + htmlFor */}
      <label htmlFor="email">이메일</label>
      <input
        id="email"
        name="email"
        type="email"
        required
        aria-required="true"
        tabIndex={0}
      />
      {error && <p role="alert" aria-live="polite">{error}</p>}
      <button type="submit" disabled={isLoading}>
        {isLoading ? '처리 중...' : '제출'}
      </button>
    </form>
  )
}

export default MyForm
```

### 2-4. 이미지 접근성

```tsx
// ✅ alt 필수
<img src={product.imageUrl} alt={`${product.name} 제품 이미지`} />

// ✅ 장식용 이미지
<img src="/decoration.png" alt="" role="presentation" />

// ❌ 금지
<img src={url} />  // alt 없음
```

### 2-5. 인증 토큰 저장

```typescript
// ✅ httpOnly cookie (서버사이드)
res.setHeader('Set-Cookie', [
  `token=${jwt}; HttpOnly; Secure; SameSite=Strict; Path=/; Max-Age=86400`
])

// ❌ 절대 금지 — XSS 취약점
localStorage.setItem('token', jwt)
sessionStorage.setItem('token', jwt)
```

### 2-6. CORS 설정

```typescript
// ✅ 화이트리스트
const ALLOWED_ORIGINS = [
  'https://myapp.com',
  'https://staging.myapp.com',
  process.env.NODE_ENV === 'development' ? 'http://localhost:3000' : '',
].filter(Boolean)

// ❌ 절대 금지
Access-Control-Allow-Origin: *
```

### 2-7. CSS 디자인 시스템 토큰

```css
/* ✅ 토큰 사용 */
.button-primary {
  background-color: var(--color-primary);
  color: var(--color-bg);
  border-radius: var(--radius-md);
  box-shadow: var(--shadow-sm);
}

/* ❌ 하드코딩 금지 */
.button-primary {
  background-color: #2563eb;
}
```

### 2-8. 에러 바운더리

```typescript
// 모든 페이지/주요 컴포넌트에 에러 바운더리 적용
class ErrorBoundary extends React.Component<
  { children: React.ReactNode; fallback?: React.ReactNode },
  { hasError: boolean; error?: Error }
> {
  state = { hasError: false }

  static getDerivedStateFromError(error: Error) {
    return { hasError: true, error }
  }

  componentDidCatch(error: Error, info: React.ErrorInfo) {
    console.error('[ErrorBoundary]:', error, info)
  }

  render() {
    if (this.state.hasError) {
      return this.props.fallback ?? (
        <div role="alert">
          <h2>오류가 발생했습니다</h2>
          <button onClick={() => this.setState({ hasError: false })}>
            다시 시도
          </button>
        </div>
      )
    }
    return this.props.children
  }
}
```

### 2-9. 컴포넌트 분할 기준

```
파일이 250줄 초과 시:
  → 커스텀 훅 분리: use[Name].ts
  → 서브 컴포넌트 분리: [Name]Item.tsx, [Name]List.tsx
  → 유틸리티 분리: [name].utils.ts
  → 타입 분리: [name].types.ts
```

### 2-10. Atomic Design 계층 구조 (v4.0 신규)

React/Next.js 프로젝트에서 컴포넌트를 5계층으로 구성:

```
components/
  atoms/         ← 최소 단위 (Button, Input, Badge, Icon)
  molecules/     ← atoms 조합 (SearchBar, FormField, Card)
  organisms/     ← molecules 조합 (Header, ProductList, LoginForm)
  templates/     ← 페이지 레이아웃 (DashboardLayout, AuthLayout)
  pages/         ← 실제 데이터 + templates (Next.js: app/ 디렉토리)
```

규칙:
- atoms: props만 받음, 내부 상태 최소화, 재사용성 최대
- molecules: 1~3개 atoms 조합, 단일 책임 원칙
- organisms: 비즈니스 로직 포함 가능, API 호출 허용
- templates: 레이아웃만 정의, 데이터 없음
- 상위 계층이 하위 계층을 import (역방향 금지)

### 2-11. Next.js App Router 패턴 (v4.0 신규)

```typescript
// app/[feature]/
//   page.tsx        ← Server Component (기본)
//   layout.tsx      ← 공유 레이아웃
//   loading.tsx     ← Suspense fallback
//   error.tsx       ← Error Boundary
//   not-found.tsx   ← 404 처리

// Server Component (기본값 — fetch, DB 직접 접근 가능)
// app/products/page.tsx
export default async function ProductsPage() {
  const products = await db.product.findMany()  // 서버에서 직접 조회
  return <ProductList products={products} />
}

// Client Component (상호작용 필요 시만)
// components/organisms/ProductFilter.tsx
'use client'
import { useState } from 'react'
export function ProductFilter({ onFilter }: { onFilter: (q: string) => void }) {
  const [query, setQuery] = useState('')
  return <input value={query} onChange={e => { setQuery(e.target.value); onFilter(e.target.value) }} />
}

// Server Action (폼 제출, 데이터 변경)
// app/products/actions.ts
'use server'
export async function createProduct(formData: FormData) {
  const name = formData.get('name') as string
  await db.product.create({ data: { name } })
  revalidatePath('/products')
}
```

패턴 규칙:
- Server Component 우선 → 필요 시만 'use client' 추가
- 데이터 페칭: Server Component에서 직접 (fetch 래퍼 금지)
- 폼 제출: Server Action 사용 (API Route 대신)
- 상태 공유: URL SearchParams (서버) 또는 Zustand (클라이언트)

### 2-12. 상태 관리 선택 가이드 (v4.0 신규)

```
상태 유형별 최적 도구:

서버 상태 (API 데이터):
  → Next.js App Router: fetch + cache (기본)
  → 복잡한 캐싱: React Query (TanStack Query)
  → 실시간: SWR

클라이언트 전역 상태 (UI, 사용자 설정):
  → 경량: Zustand (권장 — 간단한 API)
  → 복잡: Redux Toolkit (예측 가능성 필요 시)
  → 폼: React Hook Form + zod

로컬 상태 (단일 컴포넌트):
  → useState, useReducer (항상 먼저 고려)

URL 상태 (공유 가능한 UI 상태):
  → useSearchParams, useRouter (Next.js App Router)
```

선택 기준:
```
1. useSearchParams/URL → 공유·북마크 필요한 필터/정렬
2. useState → 단순 토글, 폼 입력
3. Zustand → 여러 컴포넌트 공유, 장바구니, 모달
4. React Query → API 데이터 캐싱, 페이지네이션
5. Redux → 대규모팀, DevTools 중요, 복잡한 상태 트리
```

---

## Step 3: 진행 상태 기록 [ECO/PRO: Haiku 위임 필수]

> 스냅샷 쓰기는 Agent(model="haiku")로 실행. 메인 Sonnet 세션 직접 실행 금지.

파일 하나 완료마다 `.aura/snapshots/current.md` 업데이트:

```markdown
# AuraKit Snapshot
- Timestamp: 2025-01-15T14:30:00Z
- Mode: BUILD
- Original Request: 로그인 기능 만들어줘
- Plan: 4 files total

## Completed
- [x] src/app/api/auth/login/route.ts
- [x] src/components/LoginForm.tsx

## Remaining
- [ ] src/lib/auth.ts
- [ ] src/middleware.ts

## Last Verification
- Build: Pass (tsc --noEmit)
- Security: Pass
- Tests: 2/2 Pass

## Key Decisions
- JWT → httpOnly cookie 저장 방식 채택
- zod로 입력 검증

## Next Action
- src/lib/auth.ts 구현 시작
```

---

## Step 4: 3중 검증

### V1 — 빌드 검증 (Hook 자동)
```bash
# TypeScript
npx tsc --noEmit

# Python
python -m py_compile [file_path]
```
에러 시: 빌드 중단, 에러 출력 후 FIX 모드 제안

### V2 — 코드리뷰 + 보안 L3 (격리 서브에이전트)
```
격리 서브에이전트 실행:
  입력: 변경된 파일 목록
  체크: 에러 핸들링, 입력 검증, SQL injection, XSS, 하드코딩 시크릿
  출력: "Pass" 또는 "VULN-001: [설명] 파일:라인"
```

### V3 — 테스트 실행 (ECO/PRO: **model="haiku"** 필수)
```
Agent(model="haiku") 실행:  ← Sonnet 직접 실행 금지 (THRIFTY 위반)
  입력: 테스트 파일 목록
  실행: npm test / pytest
  출력: "N/N Pass" 또는 "N Failed: [테스트명]" (Fail-Only)
```

V2 + V3 병렬 실행 (독립적이므로):
```
Agent(V2) ─┐
             ├→ 결과 취합 → 이슈 있으면 수정
Agent(V3) ─┘
```

---

## Step 5: Pre-commit 보안 L4

security-scan.js가 staged 파일에서 자동 실행:
```bash
# 시크릿 패턴 검사
grep -rn "API_KEY=\|SECRET=\|PASSWORD=\|TOKEN=\|sk-\|ghp_\|aws_access_key" [staged_files]

# 의존성 취약점 검사
npm audit --audit-level=high
# 또는
pip audit
```

---

## Step 6: Conventional Commit

```bash
git add [변경된 파일들]
git commit -m "feat(scope): 기능 설명"

# 예시
git commit -m "feat(auth): add JWT login with httpOnly cookie"
git commit -m "feat(ui): add LoginForm with accessibility support"
git commit -m "feat(api): add /api/auth/login endpoint with zod validation"
```

---

## Step 7: 완료 리포트 (100 토큰 이내)

```
✅ BUILD 완료 — [기능명]

생성 파일:
  + src/app/api/auth/login/route.ts
  + src/components/LoginForm.tsx
  + src/lib/auth.ts
  + src/middleware.ts

검증:
  V1 Build:    ✅ Pass
  V2 Security: ✅ Pass
  V3 Tests:    ✅ 4/4 Pass

다음 단계:
  → /aura 배포 설정 추가 (vercel)
  → /aura 리뷰 실행 (전체 코드 점검)
```
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