awesome-agv

# 대화형으로 실행 — 모드를 선택하세요
npx awesome-agv
# 비대화형: 특정 스택 지정, 핵심은 항상 포함됨
...

graph TD
accessibility_principles[

규칙들은 모델이 이미 알고 있는 일반 지식이 아니라 **프로젝트별 결정 사항을 인코딩**합니다. 규칙의 모든 줄은 다음과 같은 질문에 답합니다: "이 지침 없이는 이 모델이 무엇을 잘못할까?" 

모든 세션에 로드되는 비협상적 제약 조건으로, 어떤 작업을 하든지 관계없이 발동됩니다.

| 규칙 | 강제하는 내용 |
|---|---|
Rugged Software Constitution (견고한 소프트웨어 헌법) | 적대적인 환경 자세: 요청받더라도 안전하지 않은 패턴을 거부하고, 선제적으로 유효성 검사를 추가하며, 안전하게 실패합니다 |
Security Mandate (보안 의무) | 기본적으로 거부(Deny by default), 어떤 입력도 신뢰하지 않으며, 폐쇄적으로 실패합니다 — 편의성보다 보안이 항상 우선합니다 |
Rule Priority (규칙 우선순위) | 충돌 해결 순서: 보안 → 견고함 → 완성/로깅 → 테스트 용이성 → 관용적 표현 → YAGNI |
Logging & Observability Mandate (로깅 및 관측 가능성 의무) | 모든 작업 진입점은 상관관계 ID(correlationId)와 함께 시작/성공/실패를 로깅해야 합니다 — 예외 없음 |
Architectural Pattern (아키텍처 패턴) | I/O 격리, 순수 비즈니스 로직, 의존성 역전 — 테스트 용이성을 최우선으로 하는 설계 |
Code Idioms & Conventions (코드 관용적 표현 및 규칙) | 언어-스킬 라우팅 테이블 + 완성 워크플로우: 생성 → 검증 → 수정 → 확인 → 전달 |
Code Organization Principles (코드 구성 원칙) | 기능 기반 수직 슬라이스, 공개 API 경계, 순환 의존성 없음 |
Core Design Principles (핵심 설계 원칙) | 유지보수성 > 사용자 경험(UX); 합성(Composition) > 상속(inheritance); DRY를 위한 세 가지 규칙; 병렬화하기 전에 프로파일링 수행 |
Project Structure (프로젝트 구조) | 디렉토리 레이아웃의 단일 진실 공급원 — 계층이 아닌 기능별로 구성 |
Documentation Principles (문서화 원칙) | 코드는 무엇(WHAT)을 보여주고; 주석은 왜(WHY)를 설명하며; 함수 문서는 API 계약에 사용됩니다 |

관련성이 있을 때만 모델에 활성화되며 — 적용되지 않을 때는 오버헤드가 없습니다.

**보안 원칙 (Security Principles)**: 인증(Auth), 권한 부여(authorization), 입력 유효성 검사(input validation), 암호화 연산**오류 처리 원칙 (Error Handling Principles)**: 오류 유형, 복구 전략, 리소스 정리**API 설계 원칙 (API Design Principles)**: REST/HTTP 엔드포인트, 핸들러, 응답 형식 지정**데이터베이스 설계 원칙 (Database Design Principles)**: 스키마(Schemas), 마이그레이션(migrations), 쿼리(queries), 트랜잭션 경계**테스트 전략 (Testing Strategy)**: 피라미드 비율(Pyramid ratios), 명명 규칙, 위치 지정, 테스트 더블(test doubles)**동시성 및 스레딩 원칙 (Concurrency & Threading Principles)**: 레이스 방지(Race prevention), 교착 상태 회피(deadlock avoidance), 메시지 전달**성능 최적화 원칙 (Performance Optimization Principles)**: 프로파일링 우선(Profile-first), 병목 현상 식별**설정 관리 원칙 (Configuration Management Principles)**: 환경 변수, 비밀 정보(secrets), 설정 계층 구조**모니터링 및 경고 원칙 (Monitoring & Alerting Principles)**: 상태 확인(Health checks), 메트릭(metrics), SLI/SLO**리소스 관리 원칙 (Resource Management Principles)**: 파일, 연결, 잠금(locks) — 항상 정리**데이터 직렬화 원칙 (Data Serialization Principles)**: JSON, Protobuf, 경계에서의 유효성 검사**의존성 관리 원칙 (Dependency Management Principles)**: 패키지, 고정(pinning), 라이선스 준수**명령어 실행 원칙 (Command Execution Principles)**: 쉘 명령어, 주입 방지(injection prevention), 비대화형 플래그**접근성 원칙 (Accessibility Principles)**: WCAG 2.1 AA, 시맨틱 HTML, 키보드 탐색**Git 워크플로우 원칙 (Git Workflow Principles)**: 컨벤셔널 커밋(Conventional commits), 브랜치 명명 규칙, PR 위생 관리

스킬은 온디맨드로 로드되는 심층 전문 지식 모듈이며 — 에이전트는 스킬이 관련성이 있을 때만 토큰 비용을 지불합니다.

**디버깅 프로토콜 (Debugging Protocol)**: 오류 해결을 위한 체계적인 가설 기반 접근 방식
**순차적 사고 (Sequential Thinking)**: 순차적 사고 MCP 서버에서 각색된, 반복적인 사고 사슬을 통한 동적이고 성찰적인 문제 해결
**코드 리뷰 (Code Review)**: 전체 규칙 세트에 대한 구조화된 코드 검토 프로토콜
**가드레일 (Guardrails)**: 비행 전 체크리스트 및 구현 후 자체 검토
**ADR**: 아키텍처 결정 기록(Architecture Decision Records) — 맥락과 트레이드오프를 가진 중요한 결정을 문서화하는 방식
**성능 최적화 (Performance Optimization)**: 프로파일 기반 최적화 (pprof, Lighthouse, 번들 분석)
**리팩토링 패턴 (Refactoring Patterns)**: 코드 스멜 분류법, 안전한 변환 기술, 동작 보존
**연구 방법론 (Research Methodology)**: 기술 및 패턴에 대한 구조화된 연구 프로토콜
**Git 커밋 무결성 (Git Commit Integrity)**: 독립적인 커밋별 빌드/린트/테스트 검증, 프리커밋 훅 격리, 안전한 diff 분할

**구조화된 명세 (Structured Spec)**: 요구사항-계약-테스트 추적성을 갖춘 기계가 파싱 가능한 명세 표준 (PRD, SDD, TSD, BDD, ADR, Plan) 및 다중 에이전트 슬라이싱 기능
**테스트 가능성 패턴 (Testability Patterns)**: I/O 격리, 순수 로직(pure logic), 의존성 방향 — Go, TypeScript, Python, Rust, Dart를 아우르는 코드 예시. *`architectural-pattern.md`에서 참조하여 로드됨*

**.로깅 구현 (Logging Implementation)**: 구조화된 로깅 패턴, 로그 레벨, 언어별 라이브러리 (Go slog, pino, structlog), PII(개인 식별 정보) 스크러빙. *`logging-and-observability-mandate.md`에서 참조하여 로드됨*

**.CI/CD**: 파이프라인 설계, 다단계 Docker 빌드, 이미지 스캐닝, SBOM 증명서(attestation), 환경 승격 (Level 0–2)
**CI/CD GitOps & Kubernetes**: ArgoCD, Kubernetes 배포 패턴 — `ci-cd`와 함께 번들됨

**기능 플래그 (Feature Flags)**: 출시 플래그, 비상 차단 스위치(kill switches), 실험 플래그, 라이프사이클 규칙 — PRD 게이팅을 거쳐 필요할 때만 로드되는 방식
**코드 감사 (Code Audit)**: 감사 워크플로우를 위한 참고 자료 — 차원 범위 카드 및 최종 보고서 템플릿. *`audit.md`에서 참조하여 로드됨*

workflow.

**보안 감사 (Security Audit)**: 보안 감사 워크플로우를 위한 참고 자료 — 차원 범위 카드 및 최종 보고서 템플릿. *`security-audit.md`에서 참조하여 로드됨*

workflow.

**테스트 전략 (Testing Strategy)**: 테스트 더블(Test doubles) 전략, 통합 테스트 인프라(Testcontainers, Firebase emulator), 명명 규칙(naming conventions), 테스트 구성 패턴
**모바일 테스트 (Mobile Testing)**: 모바일 E2E 테스트 패턴 — Flutter integration_test, Patrol, Maestro, 골든 테스팅(golden testing), 디바이스 매트릭스(device matrix), 테스트 데이터 관리

**프론트엔드 디자인 (Frontend Design)**: 프로덕션급 프론트엔드 인터페이스, 대담한 미학(bold aesthetics), 타이포그래피, 모션
**모바일 디자인 (Mobile Design)**: Flutter 및 React Native를 위한 플랫폼 네이티브 모바일 인터페이스

**병렬 디스패치 (Parallel Dispatch)**: MECE 작업 분해, 범위 크기 산정(scope sizing), 파일 소유권 강제화(file ownership enforcement), DAG 기반 실행, 도메인 내 병렬 디스패치를 위한 안전한 병합 프로토콜(safe merge protocol). **에이전트 프로토콜 (Agent Protocols)**: 모든 에이전트를 위한 공유 행동 프로토콜: 재귀적 중첩(recursive nesting), 사전 구현 진술(pre-implementation restatement), 에이전트 정의 캐스케이드(agent definition cascade), 병렬 디스패치 형식, 그리고 응답 대상을 지정하는 주소 라우팅을 포함한 완료 보고.

언어별 패턴, 툴링, 프로젝트 레이아웃 및 품질 명령어. 각 스킬은 `paths:`를 통해 자동 로드됩니다:

에이전트가 해당 언어의 파일에 접근할 때 트리거됩니다.

**핵심 스택 (Core stacks) (번들된 프로젝트 구조 참조 포함):**

| 스킬 | 에코시스템 | 자동 로드 시 | 
|---|---|---| 
| Go Idioms + layout | Go stdlib, error wrapping, table-driven tests, gofumpt | `**/*.go` , `**/go.mod` |
| ... | 

**커뮤니티 언어 스킬 (Community language skills):**

| 스킬 | 에코시스템 | 
|---|---| 
| Angular + layout | Angular components, signals, DI, RxJS | 
| ... | 

**데이터베이스별 스킬 (Database-specific skills):**