agentleFS
quantumaikrquantumaikr/quant.cpp/.claude/skills/qa/skill.md

qa

Skill403 starsChanged 7 months agoApache-2.0View on GitHub

quant.cpp의 통합 정합성을 검증한다. 모듈 간 경계면 불일치, 타입 시스템 정합성, quantize→attention 파이프라인, cache 무결성을 교차 비교한다. '검증', 'QA', '테스트', '정합성 확인', 'validate' 요청 시, 또는 코드 변경 후 머지 전에 자동으로 사용.

The file

Files
skill.md

QA — Integration Coherence Verification

"존재 확인"이 아닌 **"경계면 교차 비교"**가 핵심이다.

검증 대상: 5대 경계면

1. 타입 시스템 ↔ 블록 구조

TQ_TRAITS[type].type_size == sizeof(block_type)
TQ_TRAITS[type].attention != NULL  (모든 7개 타입)
tq_type_bpe(type) == sizeof(block) * 8.0 / block_size

2. Quantize → Attention 파이프라인

for each type:
  quantize(key) → attention(query, quantized) → finite score
  quantize(key) → dequantize(quantized) → MSE < threshold

3. Cache → Block

cache_append(key, value) → cache_get_block() → valid pointer
cache_append(key, value) → cache_get_value() → valid pointer
cache_share_block() → ref_count == 2

4. Progressive → Tier

append N tokens → tier(0) for recent, tier(1) for warm, tier(2) for cold
recompression: warm_type → cold_type 정확한 타입 사용 확인

5. SIMD → Generic

neon_quantize(input) == generic_quantize(input)  (bit-exact)
neon_attention(q, k) ≈ generic_attention(q, k)  (tolerance)

실행 방법

  1. 변경된 파일 목록 확인 (git diff --name-only)
  2. 해당 파일이 속한 모듈 식별
  3. 해당 모듈의 경계면 체크리스트 실행
  4. 빌드 + 테스트: cmake --build build && ctest --test-dir build
  5. 발견 사항 보고

버그 패턴 (과거 발견 사례)

패턴사례교훈
함수 포인터 NULLUniform attention 미등록 (BUG-1)traits 테이블 완전성 항상 검증
하드코딩 가정Progressive가 UNIFORM_4B 가정 (BUG-2)동적 타입 조회 사용
파라미터 무시Value cache 미저장 (BUG-3)모든 파라미터 사용 여부 확인
정수 오버플로size 계산 (BUG-4)곱셈 전 오버플로 체크

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.